json.unmarshal默认大小写敏感，字段名必须完全匹配且导出；mapstructure可通过equalfold实现不敏感解析；嵌套结构需逐层检查导出性与标签，未知字段默认静默丢弃。
Go标准库json.Unmarshal默认严格区分大小写
直接调用 json.Unmarshal 时，字段名匹配是完全大小写敏感的。比如 JSON 中是 "Password"，而结构体字段标签写成 json:"password"，该字段就会静默设为零值（""），不报错也不警告。
这不是 bug，而是 encoding/json 的设计契约：它只做字面量精确匹配，不自动做 strings.EqualFold 或其他模糊逻辑。
- 字段必须导出（首字母大写），否则连反射都不可见，更别说匹配了
- 即使字段导出，若
json:标签与 JSON key 不完全一致（大小写、下划线、拼写），就无法赋值 - 常见翻车点：
Secret string json:"secrete"（拼写错误）或Host string json:"host"对应 JSON 中的"HOST"
用 mapstructure 实现大小写不敏感解析
当必须兼容客户端传来的不规范 key（如 "PASSWORD"、"password"、"Password" 混用），又不想改结构体定义时，mapstructure 是最轻量可靠的方案。
它先用标准 json.Unmarshal 解析到 map[string]interface{}，再通过自定义 MatchName 函数做柔性匹配：
config := &mapstructure.DecoderConfig{
Result: &liveData,
TagName: "json",
MatchName: func(jsonKey, tagName string) bool {
return strings.EqualFold(jsonKey, tagName)
},
}
decoder, _ := mapstructure.NewDecoder(config)
decoder.Decode(jsonMap)
- 注意：仍需确保结构体字段导出（如
Password string），否则mapstructure也无法写入 -
TagName: "json"表示读取结构体上的json:标签作为目标名，不是硬编码字段名 - 该方式不改变原始 JSON 解析流程，仅在第二层做 key 映射，性能损耗可忽略
字段名映射必须显式声明，别依赖“自动转换”
Go 不会把 UserID 自动转成 "user_id"，也不会把 user_id（小写字段）映射到 JSON 的 "user_id" —— 两者都无效。
正确姿势只有一条：导出字段 + 显式 json: 标签：
type User struct {
UserID int `json:"user_id"`
UserName string `json:"user_name"`
IsActive bool `json:"is_active"`
}
- 字段名用 Go 习惯（PascalCase），JSON 键名用标签控制（snake_case 或 kebab-case）
- 省略标签时，
UserID只匹配 JSON 中的"UserID"，几乎没人这么发 - 想跳过某个字段？用
json:"-"，比注释掉字段更安全、语义更明确
容易被忽略的嵌套与未知字段陷阱
大小写问题常藏在嵌套结构里。比如外层 key 正确，但内层对象的字段没加标签或未导出，整个子结构就变成零值。
更隐蔽的是未知字段静默丢弃：JSON 多了个 "created_at"，而结构体没定义对应字段，默认就扔了，不会报错。
- 启用严格模式：用
json.NewDecoder(r).DisallowUnknownFields()，多出字段立即返回*json.SyntaxError - 嵌套结构体每个字段都要单独检查导出性 + 标签，不能只看顶层
- 如果 JSON 中某个字段可能为空或缺失，且业务需要区分“未传”和“传了空值”，得用指针类型，如
*string
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
