mapstructure.decode 最稳但需传结构体指针、字段导出且类型严格匹配，否则静默跳过未导出或类型不匹配字段，嵌套结构须用具体类型而非 interface{}，传参必须可寻址。
用 mapstructure.Decode 是最稳的选择，但必须传结构体指针、字段导出、类型匹配，否则静默失败——不是报错，而是字段空着你还不知道。
为什么 mapstructure.Decode 不填字段却没报错
最常见的原因是 struct 字段没导出：小写字母开头的字段（如 id int）反射不可见，mapstructure 直接跳过，不赋值也不提示。它只处理首字母大写的字段（如 ID int 或 Id int）。
- 字段必须是导出的（首字母大写），否则永远填不进去
- 即使加了
json:"user_id"tag，也不能让未导出字段变可写 -
mapstructure默认忽略 map 中 struct 未定义的 key，不会报错 - 若想捕获多余字段，得显式设
ErrorUnused: true
嵌套 map 和 slice 怎么写 struct 字段才不 panic
嵌套结构必须类型严格对应，不能靠 []interface{} 撑场面。比如 map 里有 "scores": []interface{}{95.5, 87.0}，struct 就得写 Scores []float64，写成 []interface{} 会导致解码失败或后续取值 panic。
- 嵌套对象（如
"profile": map[string]interface{}{"city": "Beijing"}）→ 对应字段必须是 struct 类型或 *struct，不能是map[string]interface{} - 切片（如
"tags": []interface{}{"go", "web"}）→ 字段必须是[]string、[]int等具体类型，不是[]interface{} - map 字段（如
Metadata map[string]string）→ 源数据必须是map[string]interface{}，且 key/value 类型要能转 - 字段是指针类型（如
Name *string）时，map 中对应 key 为nil，默认不会 new 出新指针，需配DecodeHook
传参写错 &user 还是 user？常见 cannot decode into nil struct 错在哪
这个错误不是说你的 struct 变量是 nil，而是你传给 mapstructure.Decode 的第二个参数不是地址。它内部要用反射往字段写值，必须能寻址。
- 错：
mapstructure.Decode(m, user)→user是值，不可寻址 - 对：
mapstructure.Decode(m, &user)→ 必须传指针 - 如果
user已经是指针（如*User），那就传user，别再加&，否则变成**User - 初始化 struct 变量时别漏掉零值构造：
var u User或u := User{}，再传&u
最容易被忽略的是字段导出性和类型一致性——它不报错，只是默默跳过；你得自己检查 struct 定义是否每个字段都大写、是否和 map 数据的嵌套/切片结构一一对应。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
