go结构体字段必须首字母大写导出，viper.unmarshal才可反射赋值；须用mapstructure标签而非json；必须传结构体指针；未导出、类型不匹配或键名错误均静默失败。
字段没被赋值？检查结构体字段是否导出
最常见的情况是字段始终为零值，viper.Unmarshal() 却不报错。根本原因是 Go 反射无法写入非导出字段（首字母小写）。哪怕 tag 写对了、配置也存在，Port int `mapstructure:"port"` 有效，但 port int `mapstructure:"port"` 就完全静默失效。
- 结构体字段名必须首字母大写（如
Port、DB），否则反射不可寻址 - 嵌套结构体同理：外层
DB字段要导出，内层Host string也要导出 - 切片、指针字段（如
*string、[]string）只要导出，mapstructure 能自动处理逗号分隔字符串等特殊格式
用 mapstructure 还是 json 标签？优先写 mapstructure
viper.Unmarshal() 默认走的是 mapstructure 解码器，不是 json。写 json:"port" 偶尔能 work，但行为不稳定；写 mapstructure:"port" 才是明确、可预期的。
-
omitempty在mapstructure下需写成mapstructure:",omitempty"，json:"port,omitempty"中的omitempty不生效 - 环境变量匹配（如
PORT=8080）和 YAML 键名（port: 8080）都依赖mapstructure的大小写规则，mapstructure:"PORT"比json:"PORT"更可靠 - 如果非要统一用
json标签，得显式调用viper.SetDecoderConfig(&mapstructure.DecoderConfig{TagName: "json"})
viper.Unmarshal() 静默失败的三个关键点
它不抛 panic，也不返回 error，只默默跳过字段——这是调试时最头疼的来源。
- 字段未导出 → 直接跳过，无日志、无提示
- 类型不匹配（如配置给的是字符串
"8080"，字段是int）→ mapstructure 默认尝试转换，失败则留零值，不报错 - 嵌套结构体字段名拼写错误（如
mapstructure:"databse"写错）→ 找不到对应键，跳过，仍无提示
建议在开发期加一层校验：用 viper.AllKeys() 和结构体 tag 做比对，或启用 mapstructure.WeaklyTypedInput = false 让类型错误暴露出来。
传指针！viper.Unmarshal 必须传 &struct
viper.Unmarshal(cfg) 会 panic；viper.Unmarshal(&cfg) 才正确。原因和所有反射赋值一致：只有可寻址的值才能被修改。
- 错误写法：
viper.Unmarshal(cfg)→reflect: call of reflect.Value.Set on zero Value - 正确写法：
viper.Unmarshal(&cfg)，且cfg必须是变量，不能是字面量或临时值 - 如果 cfg 是接口类型（如
interface{}），先断言为具体指针类型再传，否则反射找不到字段
真正容易被忽略的，是嵌套结构体里某个字段本身是 nil 指针（比如 DB *DBConfig 未初始化），这时 mapstructure 不会自动 new，而是跳过整个子结构——得提前初始化或用 mapstructure.DecodeHook 处理。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
