Go反射如何实现配置加载_Go配置系统设计思路_技术教程

反射加载结构体字段时，tag键名错误会导致字段被忽略；viper.Unmarshal默认不报错但可能静默跳过类型不匹配字段；手动反射赋值需传结构体指针并检查CanSet。

反射加载结构体字段时，tag 里写错 key 会导致字段被忽略

Go 反射本身不关心配置来源，只负责把值填进结构体字段。真正起作用的是 reflect.StructTag 解析逻辑 —— 它严格匹配 tag 中的 key。比如你用 yaml:"db_host"，但解析器实际调用的是 structTag.Get("json")，那这个字段就永远读不到值。

常见错误：写 yaml:"host" env:"DB_HOST"，却用 mapstructure.Decode（默认读 mapstructure tag）或自己用 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")，否则所有环境变量都会被尝试匹配，可能误覆盖