Viper不自动按ENV切换配置文件，需手动设名、设类型、加路径并调MergeInConfig；嵌套字段须用mapstructure tag；环境变量需SetEnvKeyReplacer和SetEnvPrefix才能映射；结构体字段必须显式声明tag且大小写敏感。
Go 语言没有内置的“环境自动切换”机制，多环境配置管理必须靠显式设计。核心思路是：**配置分离 + 加载控制 + 环境校验**，而不是依赖运行时猜测或硬编码。
用 Viper 动态加载 config-{env}.yaml
这是最常用、也最容易出错的方式。关键不是“能不能用”，而是“怎么用对”：
- 先设文件名：
viper.SetConfigName("config-" + os.Getenv("ENV"))，不能写死为"config-dev" - 再设类型：
viper.SetConfigType("yaml")，不设就报Unsupported Config Type "" - 路径要真实存在：
viper.AddConfigPath("./configs")，末尾不加斜杠；若写成"configs/"，拼接后可能变成"./configs//config-dev.yaml"导致失败 - Docker/K8s 中挂载的 ConfigMap 是只读的，
os.Stat能过，但viper.ReadInConfig()可能静默失败，建议加日志检查是否真正读到了内容
让环境变量与结构体字段正确映射
Viper 默认不会把 server.port 自动转成 SERVER_PORT，也不会识别 app.server.port → APP_SERVER_PORT：
- 尽早调：
viper.SetEnvKeyReplacer(strings.NewReplacer(".", "_")) - 设前缀避免冲突：
viper.SetEnvPrefix("app")，这样app.server.port对应APP_SERVER_PORT - 特殊映射用
viper.BindEnv("db.host", "PGHOST")显式绑定，不依赖命名惯例 - 别绕过 Viper 直接调
os.Getenv("SERVER_PORT")，否则会跳过 flag > env > file > default 的优先级链
用 build tags 编译期隔离环境逻辑
适合强制约束配置语义，比如“生产环境必须提供 TLS 密钥”：
立即学习“go语言免费学习笔记（深入）”；
- 每个环境一个文件，如
config_prod.go顶部加//go:build prod - 所有文件定义相同的
type Config struct{...}和func NewConfig() *Config -
config_prod.go中可写if c.TLSKeyPath == "" { return errors.New("TLSKeyPath required in prod") } - 编译时指定：
go build -tags=prod -o server ./cmd/server - 禁止在
init()里加载配置——单元测试无法替换，mock 失效
配置结构体与 YAML 字段严格对齐
嵌套结构体 unmarshal 后为空？大概率是 tag 不匹配：
- YAML 中的
redis:对应结构体字段必须有redis RedisConf `yaml:"redis"` - 大小写敏感：
yaml:"Redis"和yaml:"redis"是两个不同字段 - 不自动转换命名风格（如
redis_addr不会映射到RedisAddr），全靠yaml:"redis_addr"显式声明 - 推荐统一用小写+下划线风格，和环境变量命名保持一致，减少映射歧义
