viper.readinconfig()只加载首个匹配yaml文件，因其设计为“按名查找首个”；需用mergeconfig()手动叠加多文件，配合setenvkeyreplacer实现嵌套字段环境变量映射，并注意路径、格式及错误处理。
直接用 viper，别自己手写解析器——它能自动处理文件路径、环境变量覆盖、多格式支持，且社区验证充分。自己实现 YAML 解析容易漏掉嵌套合并、大小写敏感、缩进容错等细节，反而增加维护成本。
为什么 viper.ReadInConfig() 总是只读一个 YAML 文件
viper.ReadInConfig() 的设计就是“找到第一个就停”，不是“扫描所有匹配”。它按 AddConfigPath() 注册的顺序，在每个路径里找 SetConfigName("config") 指定的文件名（如 config.yaml），一旦命中就返回，后续路径和同名变体（如 config.prod.yaml）全被忽略。
- 常见现象：
viper.Get("database.host")返回空，但config.prod.yaml里明明写了——因为这个文件根本没被加载 - 正确做法：用
viper.MergeConfig()手动叠加，顺序即优先级（基础配置 ← 环境配置 ← 本地覆盖） -
MergeConfig()接收[]byte，需自己调用os.ReadFile("config.prod.yaml")，文件不存在时要检查err并跳过，不能panic - 嵌套字段是递归合并，
config.local.yaml只写database: { port: 5433 }就能精准覆盖端口，不影响其他字段
环境变量怎么穿透到 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")显式绑定 - 环境变量天然优先级高于文件，只要映射成功，无需额外判断逻辑
路径和格式错误导致静默失败的典型场景
CI/CD 容器里 os.Getwd() 常为 /，此时 viper.AddConfigPath("./config") 实际查的是 //config，YAML 文件存在也读不到；硬设 viper.SetConfigType("yaml") 会让 viper 忽略 .yml 扩展名，哪怕文件存在也报错。
- 加双路径：
viper.AddConfigPath("./config")和viper.AddConfigPath(".")，覆盖不同工作目录场景 - 不调
SetConfigType()，让 viper 自动根据扩展名识别（支持.yaml、.yml、.json等） - 大配置文件建议流式解析或限制 size，避免 OOM；
viper.ReadInConfig()是全量加载，没有分块机制 - 调试时加一句
fmt.Println("Loaded config file:", viper.ConfigFileUsed())，确认实际加载的是哪个文件
真正麻烦的不是加载 YAML，而是多环境叠加 + 环境变量穿透 + 路径不确定性这三者交织。每一步都看似简单，但漏掉 SetEnvKeyReplacer 或少加一个 AddConfigPath，就会在生产环境突然失效，而且很难复现。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
