viper.ReadInConfig()找不到config-dev.yaml是因为未动态设置配置名，必须调用viper.SetConfigName("config-" + os.Getenv("ENV"))并提前设ENV=dev，且需配套调用SetConfigType、AddConfigPath等方法。
直接用 viper 动态加载不同环境的配置文件是当前最稳妥的做法，硬编码文件名、在 init() 里初始化、或依赖扩展名自动推断格式，都会导致测试失败、生产启动不报错但运行时 panic。
为什么 viper.ReadInConfig() 找不到 config-dev.yaml
不是文件不存在，而是 viper 根本没按你预期的名字去读。它不会自动识别 ENV=dev 并补全后缀，必须手动拼接。
-
viper.SetConfigName("config-" + os.Getenv("ENV"))必须调用，不能写死成"config-prod" - 必须在
viper.ReadInConfig()前调viper.SetConfigType("yaml")，否则报Unsupported Config Type "" -
viper.AddConfigPath("./configs")的路径要真实存在且可读；Docker 中挂载 ConfigMap 后，os.Stat可能成功但viper.ReadInConfig()静默失败——检查挂载权限和是否带末尾斜杠 - 确保
ENV=dev已设（推荐小写），别漏掉启动命令前的环境变量赋值，比如ENV=dev go run main.go
server.port 怎么映射到 SERVER_PORT 环境变量
viper.AutomaticEnv() 默认只做全字符串匹配，server.port 会去找名为 SERVER.PORT 的环境变量，而系统里实际是 SERVER_PORT。不处理这层，永远拿不到值。
- 尽早调
viper.SetEnvKeyReplacer(strings.NewReplacer(".", "_"))，让点号转下划线 - 加前缀避免冲突：
viper.SetEnvPrefix("app")，这样app.server.port对应APP_SERVER_PORT - 特殊映射需求（如
PGHOST→db.host）用viper.BindEnv("db.host", "PGHOST")显式绑定 - 别用
os.Getenv("SERVER_PORT")手动读——绕过了viper的优先级链（flag > env > file > default）
嵌套结构体 unmarshal 后字段为空怎么办
viper 不会自动推导字段名，也不转换命名风格。它只认 yaml:"xxx" tag，且大小写敏感、严格匹配。
立即学习“go语言免费学习笔记（深入）”；
- 配置文件写
redis: { host: "127.0.0.1" }，结构体字段就必须是Host string `yaml:"host"`，不是host或Host string `yaml:"Host"` - 嵌套层级每层都要加 tag：
type Config struct { Redis RedisConfig `yaml:"redis"` }+type RedisConfig struct { Host string `yaml:"host"` } - 别混用
mapstructure和yamltag——设了viper.SetConfigType("yaml")后，必须用yamltag 才生效 - 调试时可用
viper.AllKeys()查看实际解析出的所有 key，确认是否拼写/层级/大小写一致
最常被忽略的是配置校验：即使 viper.ReadInConfig() 成功，也不代表 db.host 或 redis.addr 这类必填字段存在。上线前务必对关键字段做显式非空检查，否则服务启动不报错，第一个请求才 panic。
