Go读JSON必须先用os.ReadFile读字节流再json.Unmarshal解析；字段须大写+正确json标签，否则静默为零值；err==nil不保证数据完整，关键字段需手动校验。
Go 读 JSON 文件不是调个函数就完事，必须先读字节流再解析；传错指针、字段小写、标签不匹配，都会导致 err == nil 却拿到全零值——这是线上最隐蔽的“没报错但逻辑崩了”的根源。
为什么 os.ReadFile + json.Unmarshal 是唯一安全组合
标准库 json.Unmarshal 只接受 []byte，它根本不认识文件路径。常见翻车现场：
- 直接传
"config.json"字符串 → panic:invalid character 'c' looking for beginning of value - 用
os.Open后丢给json.Unmarshal→ 传的是*os.File，类型错，编译不过或运行时 panic - 用
bufio.Scanner逐行读再拼接 → JSON 不是行格式，换行缩进不影响结构，但手动拼容易漏字节或加多余空格
正确姿势只有两步：
- 用
os.ReadFile("config.json")一次性读取全部字节（适合小配置文件） - 若文件大或需控制内存，改用
f, _ := os.Open("config.json"); defer f.Close(); data, _ := io.ReadAll(f) - 读完立刻检查 BOM：
data = bytes.TrimPrefix(data, []byte("\xef\xbb\xbf"))，否则 UTF-8 BOM 会触发invalid character '\ufeff'
结构体字段必须大写 + json tag，漏一层就整个字段为空
Go 的反射机制只访问导出字段（首字母大写）。小写字段哪怕加了 json:"xxx" 标签，也完全被跳过，不报错、不赋值、静默为零值。
立即学习“go语言免费学习笔记（深入）”；
- 错误写法：
userID int `json:"user_id"`→userID小写，永远是0 - 正确写法：
UserID int `json:"user_id"`→ 首字母大写 + 标签对齐 - 嵌套结构体同理：内层字段如
Address struct { City string `json:"city"` }，City也必须大写，否则Address.City永远空 - 想忽略某个字段？用
json:"-"，比注释掉字段更可靠（注释可能被误删，标签是声明式控制）
遇到 null、缺失字段、类型不匹配，Unmarshal 怎么“悄悄处理”
json.Unmarshal 的容错策略是“尽力而为”，但正因如此，很多问题在日志里根本看不到痕迹：
- JSON 中是
"amount": null，目标字段是*int64→ 赋值为nil；若是普通int64→ 保持原值（未初始化就是0） - JSON 缺少
"email"字段 → 对应结构体字段不变，不会清空也不会报错 - JSON 是
"amount": "19900"（字符串），结构体字段是Amount int64→ 直接返回json: cannot unmarshal string into Go struct field ...，整个解析中断 -
omitempty只影响json.Marshal，反序列化时缺失字段不修改原值，和它无关
这意味着：不能靠 err == nil 就认定数据完整。关键字段必须手动校验，比如解析后立刻：
if req.Email == "" {
return errors.New("email is required but missing or empty")
}
别反复解析同一段 JSON 字节
每次调用 json.Unmarshal(data, &v) 都会重新做词法分析和语法树构建，CPU 和内存开销不小。高频场景（如 API 网关、MQ 消费）下，重复解析同一份原始 []byte 是典型性能浪费。
- 若 JSON 中某字段结构不确定（比如
"payload"可能是对象、数组或字符串），优先用json.RawMessage接住：Payload json.RawMessage `json:"payload"`，后续按需解析，避免提前解析失败 - 若需多次提取不同字段，考虑一次性解析成
map[string]interface{}，但注意：对data["items"].([]interface{})断言前，必须先确认items存在且非nil，否则 panic - 大文件或流式场景，用
json.NewDecoder(reader)替代json.Unmarshal，边读边解析，内存友好
最容易被忽略的点：调试时只打印 err，从不检查结构体变量本身；其实 err == nil 之后，fmt.Printf("→ %+v", v) 一眼就能看出哪层字段没填上——比盯日志快十倍。
