viper.readinconfig()只加载首个匹配yaml文件，因其设计为“按名查找首个”；需用mergeconfig()手动叠加多文件，配合setenvkeyreplacer穿透嵌套字段，并通过双addconfigpath提升路径容错。
直接用 viper 是当前最省心、最健壮的选择，但必须绕开它默认只加载单个 YAML 文件、环境变量不穿透嵌套字段、路径容错差这三大坑。
为什么 viper.ReadInConfig() 总是只读到 config.yaml 而不是 config.prod.yaml
viper.ReadInConfig() 的设计就是“按名找首个”，不是“按环境找匹配”。它会依次在 AddConfigPath() 注册的路径里搜索 SetConfigName("config") 指定的文件名，一旦发现 config.yaml 就立刻返回，根本不会继续找 config.prod.yaml 或 config.local.yaml。
常见错误现象：viper.Get("database.host") 返回空，但你确认 config.prod.yaml 里写了；或者本地调试开关没生效——因为那个文件压根没被加载。
- 必须手动调用
viper.MergeConfig()按顺序叠加，顺序即优先级：先基础配置（config.yaml），再环境配置（config.$ENV.yaml），最后本地覆盖（config.local.yaml） -
MergeConfig()接收[]byte，得自己用os.ReadFile()读取内容，不能传路径 - 每次
os.ReadFile()都要检查err，文件不存在是合法场景，别panic - 嵌套结构（如
database）会递归合并，不是全量替换；所以config.local.yaml里只写database: { port: 5433 }就能只覆盖端口
如何让 DB_HOST 环境变量真正覆盖 database.host
默认情况下，viper.AutomaticEnv() 只会把 DB_HOST 映射到顶层 key db_host，根本不会对应到 database.host。要穿透点号层级，必须同步设置：
- 调用
viper.SetEnvKeyReplacer(strings.NewReplacer(".", "_"))，让database.host→DATABASE_HOST - 确保结构体字段有
yaml:"host"标签，且 YAML 里写的是host: localhost（大小写敏感） - 如果环境变量名不遵循大写+下划线规则（比如
PGHOST），得用viper.BindEnv("database.host", "PGHOST")显式绑定 -
AutomaticEnv()必须在ReadInConfig()之前调用，否则环境变量完全不参与覆盖
配置路径和格式容易静默失败的几个关键点
CI/CD 容器里 os.Getwd() 常为 /，AddConfigPath("./config") 实际查的是 //config，导致 YAML 静默失败；同时硬设 SetConfigType("yaml") 会让 viper 忽略 .yml 扩展名，哪怕文件存在也报错。
- 用双路径：
viper.AddConfigPath("./config")和viper.AddConfigPath(".")，覆盖不同工作目录场景 - 不要调
SetConfigType()，让viper根据文件扩展名自动识别（支持.yaml、.yml、.json等） -
ReadInConfig()必须检查error：若返回viper.ConfigFileNotFoundError，可 fallback 到默认内存配置；其他error应log.Fatal - 解析到结构体前，先用
viper.AllKeys()粗略校验关键字段是否存在，避免静默失败
真正难的不是读取配置，而是让多环境差异清晰可见、不可绕过——比如把 APP_ENV 作为配置路径的一部分：viper.AddConfigPath(fmt.Sprintf("./conf/%s", env))，而不是靠一堆 if-else 分支判断；另外，大文件别用 os.ReadFile，小心 OOM 和损坏。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
