Go / 系统课时
用 struct 表达业务数据
用 struct 表达业务数据
当一组字段共同描述一个业务对象时,用多个独立变量会很快失去语义。Go 的 struct 可以把姓名、年龄、地址等字段组合成一个明确的数据类型,并通过复合字面量安全地创建实例,为后续方法、JSON 序列化和接口参数建模提供统一的数据边界。
学习目标
- 能定义包含不同字段类型的结构体,并读写字段
- 能使用命名字段复合字面量创建结构体值
- 能判断匿名初始化的适用范围,并利用零值检查遗漏字段
用字段表达业务含义
结构体声明使用 type 定义新类型,字段名决定调用端如何读取数据。对业务模型,字段应表达稳定含义,而不是临时计算过程。例如用户资料可以包含字符串、整数、布尔值和另一个结构体。
package main
import "fmt"
type Address struct {
City string
ZipCode string
}
type User struct {
ID int
Name string
Age int
Active bool
Address Address
}
func main() {
var u User
fmt.Printf("zero: ID=%d Name=%q Active=%t City=%q\n",
u.ID, u.Name, u.Active, u.Address.City)
}预期输出:
zero: ID=0 Name="" Active=false City=""未显式赋值的字段会得到类型零值:int 为 0,string 为 "",bool 为 false,嵌套结构体的字段也继续使用各自零值。因此“字段没填”与“字段值恰好等于零值”有时无法区分;如果业务必须区分两种状态,后续可以考虑指针字段或额外状态字段。
用命名字段创建实例
业务代码优先使用命名字段复合字面量。字段顺序可以调整,新增字段时旧代码也不会因为位置错位而改变含义。
package main
import "fmt"
type Address struct {
City string
ZipCode string
}
type User struct {
ID int
Name string
Age int
Active bool
Address Address
}
func main() {
u := User{
ID: 101,
Name: "Alice",
Age: 30,
Active: true,
Address: Address{
City: "Shanghai",
ZipCode: "200000",
},
}
fmt.Printf("%d %s %d %t %s %s\n",
u.ID, u.Name, u.Age, u.Active, u.Address.City, u.Address.ZipCode)
}预期输出:
101 Alice 30 true Shanghai 200000访问字段使用点号,例如 u.Name;嵌套字段继续使用点号,例如 u.Address.City。字段名首字母大写时可从其他包访问,首字母小写时只在当前包内可见,这会直接影响后续 JSON、数据库映射和跨包调用的设计。
比较命名字段与匿名初始化
同一包内可以按字段声明顺序写匿名初始化,例如 User{101, "Alice", 30, true, Address{"Shanghai", "200000"}}。它更短,但调用端必须记住所有字段的位置,一旦字段顺序调整,代码就需要同步修改。
package main
import "fmt"
type Point struct {
X int
Y int
}
func main() {
named := Point{X: 3, Y: 4}
positional := Point{3, 4}
fmt.Println(named)
fmt.Println(positional)
}预期输出:
{3 4}
{3 4}对于 Point 这类字段少、含义稳定的局部类型,匿名初始化尚可接受;对于 User、Order、Config 等业务模型,优先写 Field: value。这样代码审查时能直接看出每个值对应哪个字段,也能只初始化当前需要的字段。
让模型便于后续扩展
结构体建模时先保持字段职责单一。以订单为例,金额可以用整数“分”保存,避免直接用 float64 表示货币;状态可以先用字符串常量,后续再收紧为自定义类型。若准备序列化为 JSON,还可以在字段后增加标签,例如给 Name 字段增加 json:"name" 标签;标签只描述外部编码名称,不会改变 Go 字段本身的类型。
检查一个结构体是否适合继续扩展,可以看三点:字段名是否能脱离注释读懂、零值是否会产生歧义、创建实例时是否能通过命名字段明确表达意图。满足这三点后,再给它增加方法、JSON 标签或接口层映射,维护成本会明显更低。