go结构体嵌套必须严格对齐json层级，字段名首字母大写且用json标签显式映射，禁止匿名嵌入或伪路径语法；动态key用map[string]t，混合类型数组用[]json.rawmessage，空对象与null需区分处理。
结构体嵌套必须严格对齐JSON层级
Go 的 json.Unmarshal 不会自动“展开”或“路径匹配”，json:"user.name" 这类标签根本无效——它只在当前层级找键名完全一致的字段。你看到的空字段、零值，90% 是因为结构体没按 JSON 实际嵌套深度建模。
- JSON 里有
{"profile": {"age": 25, "city": "Beijing"}}，就必须定义Profile Profile `json:"profile"`字段，且Profile是一个独立的导出 struct - 字段名必须首字母大写：
Age int `json:"age"`，小写age int永远不会被填充 - 别用匿名嵌入（如
struct{ Name string } `json:"user"`），这会让字段“提升”到外层，破坏层级对应关系 - 顶层是对象不是数组，就别用
[]struct{}；顶层是数组才用切片
动态 key（如日期、ID）只能用 map[string]T
微服务间常传类似 {"2024-06-01": {"status": "ok"}, "2024-06-02": {"status": "error"}} 这种 key 不固定的结构。硬塞进 struct 会失败，但也不该退化成 map[string]interface{}。
Json Schema Toolkit
下载
使用 JSON Schema 验证 JSON 数据，从示例 JSON 生成 schema，并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。
- 优先定义具体类型：
type DailyStatus struct { Status string `json:"status"` } - 再声明字段：
Daily map[string]DailyStatus `json:"daily"` - 避免
map[string]interface{}+ 链式断言：v["2024-06-01"].(map[string]interface{})["status"]—— 一次类型不匹配就 panic - 如果 value 结构也动态，用
map[string]json.RawMessage缓存原始字节，后续按需解码，减少重复解析开销
混合类型数组必须用 []json.RawMessage
API 返回的数组元素类型不一致（比如 [{"type":"user","id":1}, {"type":"system","priority":5}]），强行解到统一 struct 会导致字段丢失或静默忽略。
- 字段声明为：
Items []json.RawMessage `json:"items"`（注意：必须是 struct 字段，不能用于局部变量） - 遍历每个
json.RawMessage，先解到含Type string的临时 struct 判断类型 - 再二次解码到对应目标 struct：
json.Unmarshal(raw, &User{})或json.Unmarshal(raw, &SystemAlert{}) -
json.RawMessage是[]byte别名，零拷贝，性能优于反复解析
空对象 {} 和 null 字段的行为差异很关键
微服务通信中，上游可能返回 "data": {} 或 "items": null，这两者在 Go 里行为完全不同，影响后续逻辑判断。
-
{"data": {}}解到 struct 字段 → 字段存在，所有子字段为零值；解到map[string]interface{}→ 得到空 map -
"items": null解到[]Item→ 得到nilslice（len(items) == 0但items == nil） -
"items": []解到[]Item→ 得到长度为 0 的非 nil slice - 别直接用
if items != nil判断是否有数据，应统一用len(items) > 0或显式区分语义（如nil表示未提供，空 slice 表示明确为空）
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
