Go / 系统课时

用 struct 表达业务数据

用 struct 表达业务数据

当一组字段共同描述一个业务对象时,用多个独立变量会很快失去语义。Go 的 struct 可以把姓名、年龄、地址等字段组合成一个明确的数据类型,并通过复合字面量安全地创建实例,为后续方法、JSON 序列化和接口参数建模提供统一的数据边界。

学习目标

  • 能定义包含不同字段类型的结构体,并读写字段
  • 能使用命名字段复合字面量创建结构体值
  • 能判断匿名初始化的适用范围,并利用零值检查遗漏字段

用字段表达业务含义

结构体声明使用 type 定义新类型,字段名决定调用端如何读取数据。对业务模型,字段应表达稳定含义,而不是临时计算过程。例如用户资料可以包含字符串、整数、布尔值和另一个结构体。

go
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)
}

预期输出:

text
zero: ID=0 Name="" Active=false City=""

未显式赋值的字段会得到类型零值:int 为 0,string 为 "",bool 为 false,嵌套结构体的字段也继续使用各自零值。因此“字段没填”与“字段值恰好等于零值”有时无法区分;如果业务必须区分两种状态,后续可以考虑指针字段或额外状态字段。

用命名字段创建实例

业务代码优先使用命名字段复合字面量。字段顺序可以调整,新增字段时旧代码也不会因为位置错位而改变含义。

go
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)
}

预期输出:

text
101 Alice 30 true Shanghai 200000

访问字段使用点号,例如 u.Name;嵌套字段继续使用点号,例如 u.Address.City。字段名首字母大写时可从其他包访问,首字母小写时只在当前包内可见,这会直接影响后续 JSON、数据库映射和跨包调用的设计。

比较命名字段与匿名初始化

同一包内可以按字段声明顺序写匿名初始化,例如 User{101, "Alice", 30, true, Address{"Shanghai", "200000"}}。它更短,但调用端必须记住所有字段的位置,一旦字段顺序调整,代码就需要同步修改。

go
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)
}

预期输出:

text
{3 4}
{3 4}

对于 Point 这类字段少、含义稳定的局部类型,匿名初始化尚可接受;对于 User、Order、Config 等业务模型,优先写 Field: value。这样代码审查时能直接看出每个值对应哪个字段,也能只初始化当前需要的字段。

让模型便于后续扩展

结构体建模时先保持字段职责单一。以订单为例,金额可以用整数“分”保存,避免直接用 float64 表示货币;状态可以先用字符串常量,后续再收紧为自定义类型。若准备序列化为 JSON,还可以在字段后增加标签,例如给 Name 字段增加 json:"name" 标签;标签只描述外部编码名称,不会改变 Go 字段本身的类型。

检查一个结构体是否适合继续扩展,可以看三点:字段名是否能脱离注释读懂、零值是否会产生歧义、创建实例时是否能通过命名字段明确表达意图。满足这三点后,再给它增加方法、JSON 标签或接口层映射,维护成本会明显更低。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用 struct 表达业务数据

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通