json.unmarshal返回nil但字段为空，因只填充可导出字段（首字母大写）；小写字段需加json:"name"标签；嵌套结构体也须导出；避免用map[string]interface{}中转，应直解到目标struct。
json.Unmarshal 为什么返回 nil 但结构体字段还是空
常见现象是调用 json.Unmarshal 没报错，结构体变量却全是零值。根本原因：Go 的 JSON 反序列化只填充**可导出字段**（首字母大写），小写字母开头的字段直接被忽略，连错误都不会报。
- 检查结构体字段是否都以大写字母开头，比如
type User struct { Name string }合法，name string不会赋值 - 如果必须用小写字段（如内部状态），得加 JSON 标签显式绑定：
Name string `json:"name"` - 注意嵌套结构体也要满足导出规则，否则整个嵌套层级都为空
- 别依赖
fmt.Printf("%+v")看结果——它会打印未导出字段的零值，容易误判；用fmt.Println或断点观察实际字段值更可靠
struct tag 里 json:"xxx" 和 json:"-" 的区别
标签控制字段是否参与反序列化，以及怎么映射。最常踩的坑是以为 json:"-" 是“忽略”，其实它是“强制忽略且不报错”，而漏掉标签默认是“按字段名匹配”。
-
json:"user_id"：把 JSON 中的"user_id"字段映射到该 Go 字段 -
json:"user_id,omitempty"：反序列化时仍接收"user_id"，但序列化时若值为零值则不输出 -
json:"-"：彻底跳过这个字段，无论 JSON 里有没有对应 key，也不校验类型 - 空标签
json:""等价于无标签，走默认字段名匹配，不是忽略
遇到 invalid character 'x' looking for beginning of value 怎么定位
这是 json.Unmarshal 最典型的错误，说明传给它的不是合法 JSON。问题往往不在解析逻辑本身，而在上游数据来源。
- 检查输入是不是带 BOM 的 UTF-8 文件或响应体——
0xEF 0xBB 0xBF会让json.Unmarshal直接失败 - 确认数据没被意外截断，比如 HTTP 响应没读完、日志拼接错误、字符串被提前
strings.TrimSpace掉了引号 - 用
bytes.HasPrefix(data, []byte{0xEF, 0xBB, 0xBF})判断 BOM，用json.Valid(data)快速验证是否为有效 JSON - 别直接用
string(body)打日志——二进制响应可能含不可见控制字符，改用fmt.Printf("%q", body)查看原始字节
map[string]interface{} 转 struct 的坑比想象中多
很多人先用 json.Unmarshal 解到 map[string]interface{}，再手动赋值给 struct，这绕开了类型安全，也埋下隐患。
- JSON 数字在
map[string]interface{}里默认是float64，转成 struct 的int字段会 panic，需显式类型断言 - 时间字段如
"2024-01-01"进来是 string，struct 里却是time.Time，不写自定义 UnmarshalJSON 就会失败 - 嵌套 map 或 slice 里的类型不确定，运行时 panic 风险高，不如一步到位用
json.Unmarshal直接解到目标 struct - 真要中转，用
github.com/mitchellh/mapstructure比手写安全，但它也不处理类型转换细节，比如 string → time.Time 仍需注册 decode hook
最稳的路径永远是：确保 JSON schema 稳定，定义好 struct，直接 json.Unmarshal(data, &v)。中间多绕一层，debug 成本翻倍。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
