mapstructure.decode最稳但需满足三条件：字段必须导出（首字母大写）、类型严格匹配、传入可寻址指针；否则静默跳过，不报错不警告。
用 mapstructure.Decode 是最稳的，但字段不导出、类型不匹配、传参不是指针——这三个问题只要踩中一个，它就默默跳过赋值，连错都不报。
字段必须首字母大写，小写字段永远填不进去
哪怕加了 json:"user_id" 或 mapstructure:"user_id" tag，id int 这种小写字段依然不可写。反射看不见，mapstructure 直接跳过，不会 panic，也不会 warn。
- 错误写法：
type User struct { id int `json:"user_id"` }→ 字段id永远为空 - 正确写法：
type User struct { ID int `json:"user_id"` }或Id int `json:"user_id"` - 注意：tag 只负责键名映射，不改变字段可见性；导出性（首字母大写）是硬门槛
嵌套结构和切片类型必须严格对应
map[string]interface{} 里有 "scores": []interface{}{95.5, 87.0}，你就不能在 struct 里写 Scores []interface{} —— 后续取值会 panic，或丢精度。
- 嵌套 map（如
"profile": map[string]interface{}{"city": "Beijing"}）→ struct 字段必须是Profile ProfileStruct或*ProfileStruct，不能是map[string]interface{} - 切片（如
"tags": []interface{}{"go", "web"}）→ 字段得是Tags []string，不是[]interface{} - map 字段（如
Metadata map[string]string）→ 源数据必须是map[string]interface{}，且 value 要能转成string
mapstructure.Decode 必须传可寻址的指针
常见错误是写 mapstructure.Decode(m, user)，结果报 cannot decode into nil struct —— 这个错不是说 user 变量是 nil，而是你没传地址，它没法往里写值。
- 错：
var u User; mapstructure.Decode(m, u)→u是值，不可寻址 - 对：
var u User; mapstructure.Decode(m, &u) - 如果变量已是指针（
u := &User{}），就直接传u，别写&u，否则变成**User - 初始化建议：
u := User{}或var u User，再传&u，避免零值未构造
多余字段不报错，默认静默忽略
源 map 里有 "unknown_field": "xxx"，但 struct 没定义对应字段？默认什么也不做，也不提示。等你上线后发现某个配置没生效，才回头翻日志。
- 想捕获这类问题，得显式启用：
mapstructure.Decode(&mapstructure.DecoderConfig{ ErrorUnused: true, Result: &u, Raw: m }) - 宽松类型转换（如 string → int）需开
WeaklyTypedInput: true，但别滥用，容易掩盖格式问题 - 字段是
*string类型，而 map 对应 key 是nil，默认不会 new 出新指针；要处理，得配DecodeHook
最容易被忽略的是：它不报错，只是空着字段。你得自己核对 struct 定义是否每个字段都导出、类型是否和 map 数据结构完全对齐——尤其是嵌套层和切片元素类型。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
