viper.Unmarshal 不生效主因是字段未导出、嵌套结构体非导出、interface{}中转丢失类型、字段名匹配失败或未配置解码钩子；需确保字段导出、配置DecoderConfig并注册hook、避免nil指针。
为什么 viper.Unmarshal 有时不生效？
因为 Viper 默认只映射顶层字段，嵌套结构体、私有字段、未导出字段（首字母小写）直接被跳过。反射无法访问私有成员，viper.Unmarshal 底层用的是 reflect.Value.Set，而它对不可寻址或不可设置的字段静默失败——不报错，也不赋值。
- 确保结构体字段全部以大写字母开头（即导出字段），否则反射拿不到
Field - 嵌套结构体字段必须也是导出类型，且不能是
interface{}或未初始化指针 - 如果用了
map[string]interface{}中转，Viper 会丢掉类型信息，导致结构体字段匹配失败 - 检查字段是否有
vipertag，比如`mapstructure:"db_host"`，否则按字段名全小写匹配（DBHost → dbhost，不是db_host）
如何让反射正确处理时间、自定义类型和指针字段？
Viper 的反射映射本质是靠 mapstructure 库做转换，它不直接调用类型自身的 UnmarshalText 或 UnmarshalJSON，除非你显式启用。默认情况下，time.Time 字符串（如 "2024-01-01"）会映射失败，*string 也不会自动解引用赋值。
- 在
viper.Unmarshal前调用viper.SetDecoderConfig(&mapstructure.DecoderConfig{...})，配置DecodeHook - 为
time.Time注册 hook：用mapstructure.StringToTimeHookFunc("2006-01-02") -
*T类型字段需手动 new 出实例再传入，否则reflect.Value.Set会 panic：「cannot set unaddressable value」 - 自定义类型要实现
TextUnmarshaler接口，并在 hook 中桥接，否则只能靠字段名硬匹配原始字符串
自己用 reflect 手动映射比 viper.Unmarshal 强在哪？
手动反射能绕过 mapstructure 的类型擦除和默认策略限制，比如支持动态字段名、运行时决定是否忽略空值、兼容 YAML 锚点/别名、甚至注入校验逻辑。但代价是代码变厚、易出 panic，且失去 Viper 的热重载感知能力。
- 用
reflect.Value.Addr().Interface()确保目标是可寻址值，避免「cannot set」错误 - 遍历
reflect.TypeOf的Field时，先CanInterface()再Tag.Get("mapstructure")，否则 tag 取不到 - 对
nil指针字段，需用reflect.New(field.Type.Elem())初始化后再Elem().Set() - YAML 中的
null映射到 Go 的零值是安全的，但映射到*T会留nil，需额外判断
viper.Unmarshal 和原生 json.Unmarshal 在反射层面有何关键差异？
两者都用反射，但入口不同：json.Unmarshal 从 json.RawMessage 解析后直接填入目标，字段名匹配走 json: tag；而 viper.Unmarshal 先把所有配置转成 map[string]interface{}，再靠 mapstructure 一层层递归匹配字段——这中间多了一次类型丢失和 key 标准化（如 DB-URL → dburl）。
立即学习“go语言免费学习笔记（深入）”；
- Viper 默认开启
AutomaticEnv和 key 转换（kebab→snake），可能让字段名对不上 - JSON 解析能触发
UnmarshalJSON方法，Viper 不触发，除非你在DecodeHook里手动调用 - 遇到
interface{}字段，json保留原始类型（float64 / string），Viper 统一转成map[string]interface{}，后续再映射易出类型错 - 性能上，Viper 多一次 map 构建 + mapstructure 遍历，千级配置项下延迟明显高于直接
json.Unmarshal
