Go结构体必须严格镜像JSON层级,字段首字母大写、显式命名嵌套结构体并配json tag,动态key用map[string]T,null/多类型字段用*json.RawMessage或interface{},避免匿名struct。

结构体必须镜像JSON层级,不能靠匿名嵌套“偷懒”
Go 的 json.Unmarshal 不会自动展开嵌套对象——它只认你写的结构体字段是否与当前 JSON 层级的 key 严格对应。很多人把嵌套字段写成无名字段(比如直接写 Nest 而不是 Nest Nest),结果 Go 当成“嵌入结构体”,把 ID 提升到外层,导致解码失败或字段为空。
- 错误写法:
Nest(无类型、无字段名)→ Go 认为是嵌入,期望 JSON 是{"ID":"12345"},而非{"Nest":{"ID":"12345"}} - 正确写法:
Nest Nest `json:"Nest"`,配合独立的type Nest struct { ID string `json:"ID"` } - 所有字段首字母必须大写,否则
encoding/json完全不可见,值永远是零值
动态 key(如 "0", "1", "28253266")必须用 map[string]T,不是 []struct{}
看到 JSON 里 "trials": {"0": {...}, "1": {...}} 或 "instances": {"28253266": {...}},第一反应不该是切片——那是数组;这是对象,key 是字符串 ID,天然对应 map[string]T。
- 用
[]struct{}强行解析会报错:json: cannot unmarshal object into Go value of type []struct -
map[string]struct{ Index int `json:"index"` }可直接接收任意字符串 key,无需预定义 key 名 - 注意:map 的 value 类型要是具体结构体或具名类型,别全用
map[string]interface{},否则后续访问要层层断言,易 panic
遇到 null、缺失、类型不固定字段(如 RT、gtAns),别硬设类型
像 "RT": null 或 "gtAns": "yes" 或 "gtAns": true 这种字段,如果强行声明为 string 或 bool,解码时直接失败。Go 没有“联合类型”,但有更稳的绕法。
-
RT *json.RawMessage:指针 +RawMessage可安全接收null、缺失、任意 JSON 值,后续再按需解析 -
GotAnswer interface{}:保留原始形态,适合后期做类型分支判断(if s, ok := v.(string)) - 避免用
interface{}接整个结构体,那只是把问题往后推;只在真正动态的字段上妥协
别在结构体里塞太多匿名 struct{},提取成具名类型才好维护
写 Answers struct { Training []struct{...} `json:"training"` } 看似省事,但初始化、测试、加方法、写单元验证全变麻烦——Go 不支持跨层级字面量赋值,也没法给匿名 struct 加方法。
立即学习“go语言免费学习笔记(深入)”;
- 改成
Training []AnswerItem+type AnswerItem struct { Answer int `json:"ans"` ... } - 具名类型可复用(比如多个 API 都有
AnswerItem)、可加方法(func (a AnswerItem) IsCorrect() bool)、可单独测试 - Swagger 文档、IDE 自动补全、团队协作都依赖具名类型,不是“多此一举”
最常被忽略的一点:嵌套越深,越要警惕字段名大小写和 json tag 是否漏写、拼错——json:"ans" 写成 json:"Ans" 或漏掉 tag,字段就静默丢数据,连 warning 都没有。


















