Golang结构体定义与字段访问规则

go中结构体字段导出性仅由首字母大小写决定：大写可导出，小写不可导出；嵌入字段提升、反射访问、jsON序列化均受此规则约束。

结构体字段首字母大小写决定是否可导出

Go 语言中结构体字段能否被其他包访问，只看字段名首字母是否大写。小写字母开头的字段是私有的，即使结构体本身可导出，该字段也无法从外部包直接读写。

• type User Struct { Name String; age int }：外部包能读写 Name，但无法访问 age
• 没有 public/private 关键字，全靠命名约定控制可见性
• 嵌套结构体字段也遵循同样规则：若嵌入的是未导出结构体（如 inner），其字段即使大写也无法导出

嵌入字段（匿名字段）的访问与提升规则

当结构体嵌入另一个类型（如 time.Time 或自定义结构体）时，Go 会尝试“提升”其导出字段到外层结构体作用域，但仅限于字段名不冲突、且被嵌入类型是导出的。

• 嵌入 time.Time 后，可直接写 u.Year()，因为 Year 是导出方法，且无同名字段/方法冲突
• 若两个嵌入类型都有 ID 字段，必须显式通过 u.EmbedA.ID 或 u.EmbedB.ID 访问，否则编译报错 ambiguous selector u.ID
• 嵌入未导出类型（如 inner）时，其字段和方法不会被提升，只能通过 u.inner.field 访问（且仍受限于导出规则）

使用反射访问私有字段需绕过导出检查

标准库 reflect 包默认禁止读写未导出字段。强行操作会导致 panic：reflect: reflect.Value.Interface: cannot return value obtained from unexported field or method。

• 必须用 reflect.Value.CanAddr() && reflect.Value.CanInterface() 判断是否可安全取值
• 修改私有字段需先用 reflect.Value.Addr().Interface() 获取指针，再调用 .SetXxx()；否则 panic
• 常见于测试或序列化工具（如某些 json 解析器），但生产代码应避免依赖此行为

u := User{Name: "Alice", age: 25} v := reflect.ValueOf(&u).Elem() ageField := v.FieldByName("age") if ageField.CanAddr() && ageField.CanInterface() {     ageField.SetInt(26) }

JSON 序列化时小写字段名也能被反序列化

JSON 标准库不依赖字段导出性，而依赖结构体标签（json:"..."）。未导出字段加上 json:"field_name" 标签后，json.Unmarshal 可以成功赋值，但 json.Marshal 仍不会输出该字段。

立即学习“go语言免费学习笔记（深入）”；

• type Config struct { Port int `json:"port"`; Token string `json:"token"` }：反序列化时 token 能被设值，但序列化结果里不会有 "token" 字段
• 若标签值为 -（如 json:"-"），则该字段既不参与序列化也不参与反序列化
• 标签中加 omitempty（如 json:"name,omitempty"）只影响序列化，不影响反序列化逻辑

字段导出性是 Go 结构体最基础也最容易误判的规则——它不是语法限制，而是编译期强制的封装契约。哪怕用反射临时绕过，运行时行为也未必符合预期。真正需要跨包共享的数据，就老老实实导出字段；想隐藏实现细节，就别指望靠注释或文档代替首字母小写。