viper.ReadInConfig() 报错因默认仅在当前工作目录查找配置文件，不递归上层或子目录；需显式调用 AddConfigPath 并 SetConfigName，或用 SetConfigFile 指定完整路径。

为什么 viper.ReadInConfig() 总报 Config File "config" Not Found

不是配置文件路径错了，而是 viper 默认只在当前工作目录（os.Getwd()）找，不自动递归上层目录，也不读取 ./config/ 这类子目录下的文件。

实操建议：

Golang Uber Dig

使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等

下载

• 显式调用 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"`
• 务必加 mapstructure tag，因为 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() 打印当前映射关系，比猜快得多

配置加载看着简单，真正难的是路径、格式、环境变量三者之间的隐式耦合——哪个环节没对齐，就会静默失败。尤其在跨团队协作或部署到不同环境时，这些细节最容易被当成“玄学问题”反复排查。