反射加载结构体字段时，tag键名错误会导致字段被忽略；viper.Unmarshal默认不报错但可能静默跳过类型不匹配字段；手动反射赋值需传结构体指针并检查CanSet。
反射加载结构体字段时，tag 里写错 key 会导致字段被忽略
Go 反射本身不关心配置来源，只负责把值填进结构体字段。真正起作用的是 reflect.StructTag 解析逻辑 —— 它严格匹配 tag 中的 key。比如你用 yaml:"db_host"，但解析器实际调用的是 structTag.Get("json")，那这个字段就永远读不到值。
- 常见错误：写
yaml:"host" env:"DB_HOST"，却用mapstructure.Decode（默认读mapstructuretag）或自己用reflect.StructTag.Get("yaml")但没处理 fallback - 推荐做法：统一用一个 tag 名（如
conf:"host"），所有加载器都认它；或明确知道每个库认哪个 tag，比如viper.Unmarshal默认读mapstructure，不是json - 调试技巧：遍历字段时打印
field.Tag.Get("conf")，确认返回值非空且格式正确（不能有空格、引号、非法字符）
viper.Unmarshal 为什么有时不报错却没赋值
viper.Unmarshal 内部用的是 mapstructure.Decode，它对类型不匹配默认静默跳过，而不是 panic。比如配置里 timeout: "30s"，但结构体字段是 Timeout int，它不会转成秒数，也不会报错，只是留着零值。
- 必须开启严格模式：
viper.Set("strict_mode", true)，否则viper.Unmarshal不会校验字段是否存在、类型是否可转换 - 字段类型要和配置值语义一致：时间用
time.Duration，布尔用bool，数字优先用int64或float64（YAML/JSON 数字默认是 float64） - 嵌套结构体字段名首字母必须大写（导出），否则
mapstructure无法反射写入
用 reflect.Value.Set 赋值前必须检查 CanSet
手动用反射加载配置时，最容易踩的坑是直接对字段调 reflect.Value.Set，结果 panic：「reflect: reflect.Value.Set using unaddressable value」。这是因为传入的结构体是值拷贝，字段不可寻址。
- 必须传指针：
cfg := &MyConfig{}; v := reflect.ValueOf(cfg).Elem()，然后遍历v.Field(i)才能.Set() - 即使字段是导出的，如果结构体本身不是地址，
CanSet()返回 false —— 这不是 bug，是 Go 反射的安全限制 - 别依赖
reflect.Value.Interface()拿原始值再强转，容易 panic；优先用.Int()、.String()等方法取基础类型
环境变量覆盖配置时，viper 自动转换大小写但不处理下划线
viper 默认把环境变量名转成小写并用下划线分隔，去匹配结构体字段。比如环境变量 DB_HOST_PORT 会尝试匹配字段 DbHostPort 或 DBHostPort，但不会匹配 Db_host_port（含下划线的字段名在 Go 里不合法）。
- 字段命名建议全用 PascalCase，避免下划线；viper 的自动映射规则是：环境变量
FOO_BAR_BAZ→ 字段FooBarBaz - 如果非要支持旧环境变量名（如
REDIS_URL对应字段RedisURL），需显式设置viper.SetEnvKeyReplacer(strings.NewReplacer(".", "_", "-", "_")) - 启用
viper.AutomaticEnv()后，记得调viper.SetEnvPrefix("APP")，否则所有环境变量都会被尝试匹配，可能误覆盖
