17370845950

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），这是组合式设计的关键：

• 具名嵌套：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 返回空字段才回头翻文档。