最可控做法是手动设置配置名和路径：env := os.getenv("app_env"); viper.setconfigname("config." + env); viper.addconfigpath("./configs"); 再调用 readinconfig()。
直接用 viper.SetConfigName("config." + env) 加 viper.AddConfigPath 是最可控的做法，别指望它自动识别 ENV 或 APP_ENV —— Viper 本身不带“环境感知”逻辑，所有切换都得你手动拼文件名。
怎么让 viper 加载 config.prod.yaml 而不是 config.yaml
这是最常踩的坑：设了 APP_ENV=prod，但程序还是读 config.yaml。根本原因在于 viper.ReadInConfig() 只认你调用 viper.SetConfigName() 时传进去的名字，不会自动替换后缀。
- 必须在
viper.ReadInConfig()前，先拿到环境变量：env := os.Getenv("APP_ENV")，并 fallback 到默认值（如"dev"） - 然后显式设置：
viper.SetConfigName("config." + env) - 如果配置文件放在
./configs目录下，还得再调一次viper.AddConfigPath("./configs")（初始路径可能不同） - 推荐用
viper.MergeInConfig()加载通用配置（如config.yaml），再用viper.ReadInConfig()加载环境专属配置，避免覆盖
为什么 viper.GetString("db.host") 返回空字符串
不是文件没读到，也不是字段不存在，而是嵌套字段映射失败。Viper 默认对 database.host 这种点号路径不做自动解析，必须靠 mapstructure tag 显式声明。
- YAML 里写的是
database: { host: "127.0.0.1" }，结构体字段就得是：Host string `mapstructure:"host"` - 哪怕字段名和 YAML key 完全一致，也必须加 tag；顶层字段可省略，但只要有一层嵌套（比如
type DB struct { Host string }），内部字段就必须带 - 连字符字段（如
max-connections）要写成`mapstructure:"max-connections"`，不能驼峰 - 调试时别只信
GetString，先跑一遍viper.AllKeys()看实际解析出哪些 key
环境变量 APP_DB_HOST 怎么映射到 db.host
Viper 不会自动把 . 转成 _，APP_DB_HOST 默认压根不会被关联到 db.host，除非你明确告诉它怎么映射。
- 必须调用
viper.SetEnvKeyReplacer(strings.NewReplacer(".", "_"))，否则环境变量完全失效 -
viper.AutomaticEnv()和viper.SetEnvPrefix("APP")要成对出现，缺一不可 - 更稳妥的做法是单独绑定关键字段：
viper.BindEnv("database.host", "APP_DB_HOST")，避免全局替换影响其他逻辑 - 注意：环境变量优先级高于文件，但只对后续
Get*生效；已Unmarshal过的结构体不会自动刷新
为什么 Unmarshal 后结构体字段还是零值
常见于嵌套结构体 + 字段未导出 + tag 缺失三连击。Viper 的 Unmarshal 依赖反射，非导出字段（小写首字母）直接被跳过。
- 确保所有要映射的字段都是导出的（首字母大写），例如
Host string，不是host string - 嵌套结构体字段必须带
mapstructuretag，哪怕只是Host string `mapstructure:"host"` - 别在
init()函数里做Unmarshal，会导致测试无法注入 mock 配置；统一放到main()开始处 - 建议封装一个
NewConfig(v *viper.Viper) (*Config, error)构造函数，在里面做字段校验（比如生产环境要求TLSKeyPath != ""）
真正麻烦的不是加载逻辑，而是字段映射那一层隐式契约：YAML key、结构体字段名、mapstructure tag、环境变量命名规则，四者稍有错位，配置就静默失效。调试时优先打 AllKeys() 和 AllSettings()，比翻文档快得多。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
