Go中struct是唯一基础单元,字段首字母大小写决定导出性,推荐字段名赋值初始化,匿名字段实现组合式字段提升,方法接收者选值或指针取决于是否修改原值,私有字段不参与JSON序列化和ORM映射。

Go 语言中没有“类”,struct 就是你组织数据的唯一基础单元——它不是语法糖,而是内存布局、序列化、方法绑定的共同载体。定义和使用看似简单,但字段可见性、初始化顺序、指针语义这些细节一旦出错,轻则字段访问失败,重则序列化丢数据、方法不生效。
如何正确定义 struct:大小写决定能否跨包访问
结构体字段是否导出(即能否被其他包访问),只看首字母大小写,和是否加 public 或 private 关键字完全无关:
-
Name string→ 导出字段,外部包可读写 -
age int→ 未导出字段,仅当前包内可用(哪怕你加了注释或 tag,外部也无法访问) - 字段类型必须紧贴字段名后,不能写成
Name: string(那是 map 初始化语法) - 同名字段不允许重复,但不同结构体之间可以重名(
type User struct{ ID int }和type Order struct{ ID int }完全合法)
type User struct {
ID int `json:"id"`
Name string `json:"name"`
email string // 小写,外部包无法访问
}
三种初始化方式,选错一种就埋下维护雷
初始化不是“能跑就行”,它直接影响可读性、字段遗漏风险和后续扩展成本:
-
推荐:字段名赋值(字面量) —— 明确、安全、支持部分赋值:
u := User{ID: 123, Name: "Alice"},未填字段自动为零值(email为空字符串) -
慎用:顺序赋值 —— 必须填满所有字段,且顺序与定义严格一致:
u := User{123, "Alice", "a@example.com"};一旦结构体新增字段或调整顺序,所有这类初始化都会静默错位 -
按需:指针初始化 ——
u := &User{ID: 123}更直观;u := new(User)返回*User,但所有字段仍为零值,需手动赋值,无明显优势
嵌套与匿名字段:复用 ≠ 继承,提升字段有优先级规则
Go 不支持继承,但通过匿名字段实现“字段提升”(field promotion),这是组合式设计的关键:
立即学习“go语言免费学习笔记(深入)”;
- 具名嵌套:
Addr Address→ 访问需写u.Addr.City - 匿名嵌套:
Address(无字段名)→u.City和u.Address.City都合法;若冲突(比如User和Address都有City),优先使用直接字段(u.City) - 匿名字段只能是命名类型(如
Person),不能是基础类型(int、string)或未命名结构体
type Address struct { City, Zip string }
type User struct {
Name string
Address // 匿名字段
}
u := User{Name: "Bob", Address: Address{City: "Shanghai"}}
fmt.Println(u.City) // 输出 "Shanghai",字段被提升
方法接收者选值还是指针?不看大小,先看是否要改原值
接收者类型不是性能优化题,而是语义题:你写的这个方法,是否需要修改调用者的原始数据?
- 值接收者
func (u User) SetName(n string)→ 方法内对u.Name赋值,不影响原始变量(传的是副本) - 指针接收者
func (u *User) SetEmail(e string)→ 可修改原始User实例的字段,且调用时u.SetEmail("x@y.z")和(&u).SetEmail("x@y.z")都合法(Go 自动取址) - 同一类型的方法集必须统一:如果已有指针接收者方法,就不能再为该类型定义值接收者方法(否则方法集不一致,接口实现可能失败)
最容易被忽略的是:结构体字段的可见性在反射、JSON 序列化、数据库 ORM 中全部生效——私有字段(小写)不会被 json.Marshal 输出,也不会被 gorm 映射到数据库列。别等上线后发现 API 返回空字段才回头翻文档。










