viper.ReadInConfig()只加载首个匹配文件（如config.yaml），不扫描同前缀多环境文件（如config.prod.yaml）；需手动用MergeConfig()按base→env→local顺序叠加合并，且须显式ReadFile并校验错误。
为什么 viper.ReadInConfig() 只加载一个 YAML 文件
因为 viper.ReadInConfig() 的行为是“按名查找首个匹配文件”，不是“自动扫描同前缀所有环境文件”。它只会找你用 viper.SetConfigName("config") 指定的名字，然后在 AddConfigPath() 注册的路径里依次搜索 config.yaml、config.yml、config.json 等——一旦找到就停，根本不会继续找 config.prod.yaml 或 config.dev.yaml。
常见错误现象：viper.GetString("database.host") 返回空字符串，但你在 config.prod.yaml 里明明写了；或者本地调试开关没生效，因为 config.local.yaml 压根没被读到。
- 必须手动叠加：用
viper.MergeConfig()逐个读取并合并，顺序即优先级（基础配置 ← 环境配置 ← 本地覆盖） -
MergeConfig()接收[]byte，得自己调os.ReadFile()，不能直接传路径 - 每个
os.ReadFile()都要检查err，文件不存在是合法场景，别panic - 嵌套字段如
database.port会递归合并，config.local.yaml里只写database: { port: 5433 }就能精准覆盖端口
怎么让 ENV=prod 正确加载 config.prod.yaml
核心是别硬编码文件名，靠 os.Getenv("ENV") 动态拼接，再用 viper.SetConfigName() 设置。常见错误是写死 config.dev.yaml，导致部署时改不掉；或在 init() 里提前加载，单元测试时无法 mock 环境变量。
- 启动命令统一用
ENV=prod go run main.go，而不是改代码 - 加载逻辑放在
main()或初始化函数里，**绝对不要放init()** - 调用顺序：先
viper.AddConfigPath("./config")和viper.AddConfigPath(".")（防 CI/CD 中os.Getwd()返回/导致路径错） - 设名：
viper.SetConfigName("config." + env)，然后viper.ReadInConfig() - 不调
viper.SetConfigType("yaml")，让 viper 自动识别扩展名（支持.yaml、.yml、.json）
环境变量怎么覆盖 database.host 这类嵌套字段
默认情况下，viper.AutomaticEnv() 只会把 DB_HOST 映射到顶层 key db_host，不会穿透点号变成 database.host。必须配合 viper.SetEnvKeyReplacer() 才行。
- 加这行：
viper.SetEnvKeyReplacer(strings.NewReplacer(".", "_"))，这样database.host→DATABASE_HOST - YAML 里字段名要小写，结构体字段要有
yaml:"host"标签，大小写敏感 - 如果环境变量名不规范（比如
PGHOST），用viper.BindEnv("database.host", "PGHOST")显式绑定 - 环境变量天然优先级高于文件，只要映射成功，无需额外判断逻辑
开发用 YAML、生产为什么建议用环境变量或 JSON
YAML 在开发阶段写配置方便，缩进+注释友好；但上线后，K8s、Docker、云平台基本都靠环境变量或 ConfigMap 注入配置，YAML 文件反而成了运维负担。更关键的是，YAML 解析比 JSON 慢，且存在类型隐式转换风险（比如 yes 被转成 true），线上出问题难排查。
- 开发/测试阶段：用
viper.SetConfigType("yaml")+ 文件 - 生产环境：优先走
viper.AutomaticEnv()，配合viper.SetEnvPrefix("APP")，读APP_HTTP_PORT这类变量 - 如果必须用文件，生产上用 JSON（解析快、无歧义），设
viper.SetConfigType("json") - 所有配置项必须设默认值，避免
viper.GetString("db.host")返回空却没报错
最易被忽略的点：viper 加载失败时常常静默失败，尤其路径错或格式错；务必在 viper.ReadInConfig() 后检查 err，并打印完整错误信息——否则配置为空，服务可能连端口都绑不上。
