Gin加载config.dev.yaml或config.prod.yaml需用viper动态拼接文件名： viper.SetConfigName("config." + os.Getenv("ENV")) + AddConfigPath("./config") + SetConfigType("yaml")，启动前设ENV=dev或ENV=prod，禁用硬编码和init()初始化。
怎么让 Gin 加载 config.dev.yaml 或 config.prod.yaml
Gin 本身不处理配置加载，必须靠 viper + 环境变量联动。核心是别硬编码文件名，用 os.Getenv("ENV") 动态拼接配置名。
常见错误是写死 viper.SetConfigFile("config.dev.yaml")，结果部署到生产环境还得改代码；或者在 init() 里调 viper.ReadInConfig()，导致单元测试无法注入 mock 环境变量而失败。
- 启动时通过
ENV=prod go run main.go设置环境变量 - 代码中用
viper.SetConfigName("config." + env)，再配viper.AddConfigPath("./config") - 调
viper.ReadInConfig()前确保viper.SetConfigType("yaml")已设置 - 所有配置项必须设默认值，比如
viper.SetDefault("server.port", 8080)，避免viper.GetInt("server.port")返回 0 却无提示
为什么开发用 YAML、生产慎用 YAML
YAML 在开发阶段确实方便：支持注释、缩进直观、嵌套结构可读性强。但上线后问题集中爆发——K8s 和 Docker 默认靠环境变量或 ConfigMap 注入配置，YAML 文件反而成了运维盲点；更关键的是，YAML 解析比 JSON 慢，且存在隐式类型转换（比如 yes 被转成 true，1e3 被转成浮点数），线上出问题极难定位。
实操建议：
- 开发/测试阶段：用
viper.SetConfigType("yaml")+ 文件方式加载 - 生产环境：优先走
viper.AutomaticEnv()，配合viper.SetEnvPrefix("APP")，读取APP_SERVER_PORT这类变量 - 若必须用文件，改用 JSON 格式，设
viper.SetConfigType("json")，并禁用 YAML 解析依赖
如何避免 viper.Unmarshal 导致的字段丢失或 panic
viper.Unmarshal(&Conf) 看似简单，但字段映射失败时不会报错，只会静默忽略——比如 YAML 里写的是 db_host，而 struct tag 是 json:"dbHost"，结果 Conf.DB.Host 一直为空，直到连不上数据库才暴露。
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
关键检查点：
- struct 字段必须首字母大写（Go 导出规则），否则
viper无法写入 - YAML 键名与 struct tag 必须严格对应，推荐统一用
yaml:"db_host"tag，而非依赖默认 snake_case 转驼峰 - 嵌套结构要逐层定义 struct，不能只靠 map[string]interface{} —— 否则类型校验失效，
viper.GetInt64("db.max_open_conns")可能 panic - 加载后手动校验必填字段，例如
if viper.GetString("db.dsn") == "" { log.Fatal("missing db.dsn") }
Gin 路由分组怎么和配置版本对齐
API 版本（如 /api/v1）和配置版本（如 config.prod.yaml）是两件事，但容易混淆。路由版本控制解决的是接口契约演进，配置版本解决的是运行时参数差异。它们不该耦合，但可以协同。
典型误操作：根据 viper.GetString("env") == "prod" 决定是否注册 v2 路由——这会让测试环境无法验证 v2 逻辑。
正确做法：
- 路由版本由 URL 路径或 Accept 头决定，与配置环境无关；
r.Group("/api/v1")和r.Group("/api/v2")同时注册 - 不同版本路由内部可读取不同配置分支，比如
v2.GET("/users")里用viper.GetString("feature.new_auth")控制是否启用新鉴权逻辑 - 废弃策略靠响应头（
X-API-Deprecated: true）和文档驱动，不靠配置开关隐藏路由
配置文件里真正该区分的是数据源、超时、限流阈值这类运行时参数，而不是“要不要暴露 v2 接口”这种架构决策。
