viper 不支持自动 fallback 多配置文件，需手动按 config.json→config.yaml→config.toml 顺序检查并显式调用 setconfigtype；分段加载须用 readconfig + mergeconfig 实现 base/env/override 多层深合并，并注意环境变量与命令行参数的加载顺序及优先级。
为什么 viper 无法自动 fallback 多个配置文件
viper 不支持“先找 config.json，不存在再试 config.yaml”这种 fallback 行为。它只认一个 SetConfigName("config") + AddConfigPath("conf/") 组合，最终只加载第一个匹配的文件，不会遍历后缀列表。
常见错误现象是：你放了 config.yaml 和 config.json 在同一目录，但 viper 总是加载 JSON（或总是失败），以为它“智能识别”，其实它只是按 AddConfigPath 顺序扫描，找到第一个就停。
- 必须手动控制加载顺序：用
os.ReadFile()依次检查config.json→config.yaml→config.toml，读到第一个存在的就终止 - 读到内容后，**必须**调
viper.SetConfigType()显式声明格式，不能依赖后缀（尤其当文件名是app.conf或无后缀时） - 别把 fallback 逻辑塞进
viper.OnConfigChange——那是热重载回调，不是初始化加载策略
如何实现分段加载：base + env + override
所谓“分段式”，本质是多层合并：基础配置（config.base.yaml）+ 环境专属（config.dev.yaml）+ 运行时覆盖（环境变量或命令行参数）。viper 默认的 ReadInConfig() 只能加载单个文件，分段需手动叠加。
实操建议：
- 先用
viper.ReadConfig(bytes.NewReader(baseData))加载 base，再用viper.MergeConfig(bytes.NewReader(envData))合并 env 层——MergeConfig是深合并，同 key 会被覆盖，嵌套结构不会丢子字段 - 环境变量覆盖必须在
MergeConfig之后调viper.AutomaticEnv()，否则环境变量值不会参与最终解析 - 命令行参数用
viper.BindPFlags()绑定，但注意：flag 值优先级应高于环境变量，所以BindPFlags要在AutomaticEnv之后调用 - 避免用
viper.Set()手动设值——它不触发 merge 逻辑，容易和后续MergeConfig冲突
分段加载时结构体零值问题更隐蔽
分段加载后结构体字段仍是零值，往往不是 YAML 写错，而是某一层配置缺失导致字段未被写入。比如 config.base.yaml 定义了 server.port，但 config.dev.yaml 没有 server 这个 section，MergeConfig 就不会覆盖 server 下任何字段，结果 port 被清空。
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
排查要点：
- 用
viper.AllSettings()打印最终合并后的 map，确认 key 是否存在、类型是否正确（比如字符串"8080"没转成 int） - 结构体字段必须导出（首字母大写），且
yaml:tag 拼写准确，例如Port int `yaml:"port"`，不是`yaml:"Port"` - 如果某层配置故意留空（如 dev 环境不设数据库密码），应在 base 中提供默认值，或改用指针字段
*string区分“未设置”和“空字符串”
测试时分段路径错位导致加载失败
go test 运行时工作目录是测试文件所在路径，../conf/config.base.yaml 可能指向错误位置；而 viper.AddConfigPath("../conf") 在测试中失效，因为 ReadInConfig() 仍会按当前目录找文件名。
可靠做法是绕过 AddConfigPath，全部走字节流手动加载：
- 测试代码里用
filepath.Join("..", "conf", "config.base.yaml")构造绝对路径，os.ReadFile读取 - 对每个分段文件都做
os.Stat检查，避免ReadFile报 “no such file” 掩盖真实路径问题 - 不要在
init()里预加载配置——测试时 init 会提前执行，但此时工作目录不可控 - 若用 embed.FS，必须对每个分段文件单独
assets.ReadFile("conf/config.base.yaml")，再分别viper.MergeConfig，不能指望 embed 后自动 fallback
分段加载真正的复杂点不在语法，而在各层覆盖逻辑的手动编排与调试成本——一旦某一层漏掉 MergeConfig 或顺序颠倒，配置就静默失效，很难通过日志发现。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
