viper.ReadInConfig() 报错因默认仅在当前工作目录查找配置文件，不递归上层或子目录；需显式调用 AddConfigPath 并 SetConfigName，或用 SetConfigFile 指定完整路径。
为什么 viper.ReadInConfig() 总报 Config File "config" Not Found
不是配置文件路径错了，而是 viper 默认只在当前工作目录（os.Getwd()）找，不自动递归上层目录，也不读取 ./config/ 这类子目录下的文件。
实操建议：
- 显式调用
viper.AddConfigPath("./config")或viper.AddConfigPath(".")，再调用viper.SetConfigName("config") - 如果配置文件名带后缀（如
config.yaml），必须用viper.SetConfigFile("./config/config.yaml")，此时SetConfigName和AddConfigPath会被忽略 - 多环境时别依赖默认搜索路径——CI/CD 容器里
os.Getwd()往往是/或临时路径，容易静默失败
viper.Unmarshal() 解析嵌套结构体时字段全为零值
常见现象：YAML 里写的是 database: {host: "127.0.0.1", port: 5432}，但结构体字段始终是空字符串或 0。
根本原因是字段没加导出（首字母大写）+ 缺少 struct tag。Go 的 json/yaml 反序列化库（包括 viper 底层用的）只处理导出字段，且默认按字段名匹配，不看 YAML key。
立即学习“go语言免费学习笔记（深入）”；
实操建议：
- 结构体字段必须首字母大写，例如
Host string `mapstructure:"host"` - 务必加
mapstructuretag，因为viper.Unmarshal()默认走的是mapstructure解析器，不是yaml或json标签 - 如果嵌套层级深，别用匿名结构体混用——
mapstructure对嵌套匿名字段支持不稳定，显式命名字段更可靠
同时支持 JSON/YAML/TOML 但热重载不生效
调用 viper.WatchConfig() 后改了 YAML 文件，viper.Get("xxx") 还是旧值，控制台也没报错。
问题出在：Viper 默认只监听首次加载的那个文件，不会根据文件扩展名自动切换解析器；而且 WatchConfig() 不会自动触发 ReadInConfig()，它只是监听 fs 事件，你需要自己注册回调并手动重读。
实操建议：
- 先用
viper.SetConfigType("yaml")显式声明格式，否则改了文件但 Viper 还按上次类型解析，可能 panic - 注册回调时必须调用
viper.ReadInConfig()，否则内存里的配置不会更新：viper.OnConfigChange(func(e fsnotify.Event) { viper.ReadInConfig() }) - 注意
fsnotify在某些容器或 NFS 路径下不可靠，生产环境建议加 fallback 机制（比如定期ReadInConfig()+ etag 比对）
环境变量覆盖配置时大小写敏感导致失效
设了 export APP_DATABASE_HOST=127.0.0.1，但 viper.GetString("database.host") 还是空——因为 Viper 默认把 key 转成全大写再匹配环境变量，而你的结构体字段是 Host，对应环境变量名应该是 APP_DATABASE_HOST，不是 APP_DATABASE_host。
关键点在于：Viper 的 AutomaticEnv() 用的是 strings.ToUpper() + viper.SetEnvKeyReplacer(strings.NewReplacer(".", "_")) 的组合规则。
实操建议：
- 统一用
viper.SetEnvPrefix("APP")，再配合viper.AutomaticEnv() - 如果字段是
DBPort int `mapstructure:"db_port"`，对应环境变量就是APP_DB_PORT=5432，不是APP_DBPORT或APP_DB_PORT少下划线 - 调试时用
viper.GetEnvVars()打印当前映射关系，比猜快得多
