viper.setconfigname("config")无法加载config.dev.yaml，因其仅设基础名而不拼接环境后缀，需显式构造完整文件名如"config.dev.yaml"并确保路径存在、权限正确，且setconfigpath须在setconfigname前调用。
为什么 viper.SetConfigName("config") 无法加载 config.dev.yaml
因为 viper.SetConfigName() 只设置基础名，不参与环境后缀拼接。Viper 默认查找 config.json → config.yaml 等，但不会自动尝试 config.dev.yaml 或 config-prod.yaml。你得明确告诉它文件全名。
- 错误写法：
viper.SetConfigName("config")+viper.AddConfigPath("./configs")→ Viper 在 ./configs 下只找config.yaml，哪怕APP_ENV=dev也视而不见 - 正确做法：用环境变量动态构造完整文件名，
viper.SetConfigFile(filepath.Join("configs", "config."+env+".yaml")) -
SetConfigFile()和SetConfigName()互斥——一旦调了前者，后者失效；多环境场景建议只用SetConfigFile() - 必须确保
configs/config.dev.yaml文件真实存在、路径可读，Docker 中挂载 ConfigMap 后常因权限或路径问题静默失败
如何安全传入 APP_ENV 并避免 fallback 到零值
直接用 os.Getenv("APP_ENV") 拼接文件名风险极高：空值、拼写错误（如 "prodd"）、大小写混用（"Dev"）都会导致 Viper 静默加载失败，最终字段取到零值，调试时极难定位。
- 用
flag显式声明参数：env := flag.String("env", os.Getenv("APP_ENV"), "environment: dev/staging/prod")，再flag.Parse() - 严格校验值：
if *env != "dev" && *env != "staging" && *env != "prod" { log.Fatal("invalid APP_ENV") } - 路径构造加
filepath.Join()，避免手动拼接斜杠错误；启动前用os.Stat()检查配置文件是否存在 - 别依赖默认值兜底——
viper.SetDefault("server.port", 8080)可能掩盖环境加载失败，应优先保证加载成功
viper.AutomaticEnv() 为什么读不到 SERVER_PORT
viper.AutomaticEnv() 默认按字符串全匹配，server.port 会去找名为 SERVER.PORT 的环境变量，而实际系统里是 SERVER_PORT。点号不转下划线，前缀没设，就永远对不上。
- 必须提前调：
viper.SetEnvKeyReplacer(strings.NewReplacer(".", "_"))—— 把配置键里的点替换成下划线 - 必须提前调：
viper.SetEnvPrefix("app")—— 这样app.server.port才对应APP_SERVER_PORT - 这两步顺序不能错：必须在
viper.AutomaticEnv()之前调用，否则无效 - 特殊映射走
viper.BindEnv("db.host", "PGHOST")，避免全局替换干扰
嵌套结构体 unmarshal 后字段为空的真正原因
Viper 不推导字段名，也不做命名风格转换。它只认 struct 字段上显式的 yaml:"xxx" tag，且严格区分大小写、完全匹配 YAML 键（含连字符、下划线）。
- YAML 写
database-host: localhost，struct 字段必须是DatabaseHost string `yaml:"database-host"`，不是DatabaseHost string（缺 tag）也不是Host string `yaml:"host"`（键不匹配） - 字段首字母必须大写，小写字段（如
host string）Go 反射不可导出，viper 根本看不到 - 不要指望驼峰自动转下划线——
logLevel+yaml:"log_level"是错的，必须写LogLevel string `yaml:"log_level"` - 嵌套层级每层都要加 tag：
type Config struct { DB DBConfig `yaml:"db"` }+type DBConfig struct { Host string `yaml:"host"` }
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
