Viper 多环境配置需动态拼接文件名、显式设类型、正确处理环境变量映射及 YAML tag。必须 viper.SetConfigName("config." + env) + AddConfigPath("configs") + SetConfigType("yaml") + SetEnvKeyReplacer + AutomaticEnv()，且顺序不可错。
viper.SetConfigName 必须动态拼接环境变量
硬编码 viper.SetConfigName("config-prod") 是最常见错误——它让所有环境都去读同一个文件，或换环境直接报 Config File Not Found。Viper 不会自动识别 APP_ENV=dev 并补后缀，你得自己拼。
正确做法是：viper.SetConfigName("config." + os.Getenv("APP_ENV"))，且确保启动前已设 APP_ENV=dev（推荐小写）。如果 APP_ENV 为空，应显式 fallback 到 "dev"，否则 SetConfigName("config.") 会导致路径异常。
-
SetConfigName()和SetConfigFile()互斥：一旦调了后者，前者失效；多环境建议统一用前者 +AddConfigPath() - 别漏掉
viper.AddConfigPath("configs")，路径必须真实存在且可读；Docker 中挂载 ConfigMap 后，os.Stat可能成功但ReadInConfig()静默失败 - 若用
filepath.Join("configs", "config."+env+".yaml")构造完整路径，就该改用SetConfigFile()，别混用
viper.SetConfigType 必须在 ReadInConfig 前调用
不显式设置类型，Viper 无法识别 YAML 文件内容，会报 Unsupported Config Type ""。这不是文件不存在，而是解析器根本没启动。
必须在 viper.ReadInConfig() 之前调用 viper.SetConfigType("yaml")。即使文件名带 .yaml 后缀，Viper 也不会自动推断格式。
立即学习“go语言免费学习笔记（深入）”；
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
- 扩展名缺失（如只写
config.dev）或路径拼错（如"configs/"多了个斜杠），都会导致类型未注册 - 若同时支持多种格式（YAML/TOML/JSON），需按实际加载的文件类型设对应值，不能复用
- 调用
SetConfigType()后再调ReadInConfig()，顺序不可颠倒
viper.AutomaticEnv 需配合 SetEnvKeyReplacer 和 SetEnvPrefix
viper.AutomaticEnv() 默认只做全字符串匹配：viper.GetString("server.port") 会去找名为 SERVER.PORT 的环境变量，而系统里实际是 SERVER_PORT。不处理这层映射，永远 fallback 到默认值。
必须提前调：viper.SetEnvKeyReplacer(strings.NewReplacer(".", "_"))，再调 viper.SetEnvPrefix("app")，最后才调 viper.AutomaticEnv()。顺序错了就无效。
- 加前缀避免冲突：
app.server.port对应APP_SERVER_PORT，而不是全局污染的SERVER_PORT - 特殊映射（如
PGHOST→db.host）要用viper.BindEnv("db.host", "PGHOST")显式绑定 - 开发期建议关掉
AutomaticEnv()，避免环境变量静默覆盖 YAML 值，排查时完全看不出哪来的值
嵌套结构体 unmarshal 后字段为空？检查 yaml tag 是否严格匹配
Viper 不会自动推导字段名，也不转换命名风格（驼峰/下划线/连字符）。它只严格匹配 struct 字段上的 yaml:"xxx" tag，大小写敏感、一字不差。
配置文件写 redis: { host: "127.0.0.1" }，结构体字段就必须是 Host string `yaml:"host"`，且首字母必须大写（否则 Go 反射无法导出）。
- 嵌套层级每层都要打 tag：
type Config struct { Server ServerConfig `yaml:"server"` }+type ServerConfig struct { Port int `yaml:"port"` } - 别混用
mapstructure和yamltag：设了SetConfigType("yaml")后，必须用yamltag 才生效 - YAML 中的
null、空字符串、未定义字段，在 Go struct 中会被转成零值，viper.Get()返回interface{}，直接断言易 panic；务必用viper.GetInt("server.port")等强类型方法
最容易被忽略的是：viper 在多文件叠加时不会自动继承基础配置。如果 config.base.yaml 定义了 db.host，而 config.prod.yaml 只写了 db.port: 5432，那 db.host 在 prod 下就是空——必须显式调 viper.MergeConfigFile("configs/config.base.yaml") 补全，且要在 ReadInConfig() 之前。
