Viper 默认不展开嵌套键，需显式调用 SetConfigType("yaml") 并正确设置文件路径；环境配置推荐多文件叠加（base + env），结构体绑定需导出字段+mapstructure标签，热更新需指针封装避免竞态。
为什么 Viper 读不到 config.yaml 的嵌套字段？
常见现象是 viper.GetString("server.port") 返回空字符串，但 YAML 文件里明明写了 server: { port: 8080 }。根本原因不是语法错，而是 Viper 默认不开启自动展开嵌套键（即不把点号当层级分隔符）。
- 必须显式调用
viper.SetConfigType("yaml")，哪怕后缀是.yaml也不自动识别 - 加载前要先
viper.SetConfigFile("config.yaml")，不能只靠ReadInConfig()猜路径 - 如果用
viper.AddConfigPath("./configs")，得确保当前工作目录下真有该路径，Go 运行时不会向上递归查找 - 嵌套字段访问必须用点号，但底层结构仍是 map[string]interface{}，
viper.AllKeys()能帮你确认键名是否被正确解析
如何让 Viper 区分开发/测试/生产环境配置？
别硬编码 viper.SetEnvPrefix 后拼接环境名，容易漏掉重载逻辑。Viper 原生支持多文件叠加，更稳的方案是按环境名加载不同文件，再统一覆盖。
- 约定配置文件命名：
config.dev.yaml、config.prod.yaml，用os.Getenv("ENV")动态拼出文件名 - 先加载通用配置
config.base.yaml，再用viper.MergeConfigFile()加载环境专属配置，后者优先级更高 - 避免用
viper.AutomaticEnv()直接映射环境变量——它会把SERVER_PORT映射成server.port，但大小写转换规则和你的 YAML 字段不总一致 - 启动时加日志：
log.Printf("loaded config for env: %s, keys: %+v", env, viper.AllKeys())，防止静默加载失败
viper.Unmarshal() 绑定结构体时字段总为空？
不是结构体标签写错了就是类型没对齐。Viper 解析 YAML 后本质是 map，Unmarshal 是靠反射做字段匹配，中间任何一环断掉都会静默失败。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 结构体字段必须首字母大写（可导出），且带
mapstructure:"xxx"标签，比如Port int `mapstructure:"port"` - YAML 中写的是字符串
port: "8080"，但结构体字段是int，Viper 不会自动转类型，直接跳过赋值 - 嵌套结构体要逐层打标签，父结构体的字段名和 YAML 键名一致，子结构体内部再用
mapstructure对齐 - 调用
viper.Unmarshal(&cfg)后，务必检查返回的error，它不会 panic，但可能只是跳过某些字段
热重载配置为什么在 Web 服务中很难落地？
不是 viper.WatchConfig() 不好用，而是 HTTP handler 持有的配置快照和后台重载的内存状态天然不同步，强行热更新反而引发竞态或 panic。
立即学习“go语言免费学习笔记（深入）”；
-
viper.WatchConfig()只监听文件变化并重新解析，但已运行的 handler 用的还是旧变量地址，除非你每次请求都viper.GetInt("server.timeout") - 若想全局生效，得用指针或原子变量封装配置，比如
type Config struct{ Timeout int }+var GlobalConfig = &Config{}，重载时替换整个指针值 - 注意 fsnotify 在 Docker 容器里可能不触发事件，尤其挂载的 ConfigMap，建议 fallback 到定期轮询
viper.ReadInConfig() - 最省事的做法：接受“重启生效”，把配置变更纳入 CI/CD 发布流程，比在运行时扛住热更新的复杂度更可靠
viper.Debug()，比猜半天强。 
