根本原因是Viper不支持多后缀fallback，只按AddConfigPath顺序加载首个匹配文件；必须手动用os.ReadFile依次检查config.json→yaml→toml并显式SetConfigType，再通过ReadConfig+MergeConfig实现base/env/override三层深合并。
为什么 viper.ReadInConfig() 总是加载错文件或报 Config File Not Found
根本原因不是文件不存在，而是 viper.AddConfigPath() 扫描时只认第一个匹配的文件名+后缀组合，且不 fallback。比如你放了 config.json 和 config.yaml 在同一目录，viper.SetConfigName("config") + viper.AddConfigPath("./conf") 后调 viper.ReadInConfig()，它只会加载按文件系统顺序排在前面的那个（Linux 下通常是字典序，macOS 可能不同），不会“自动试下一个”。更糟的是，如果路径写成相对路径但当前工作目录不是你预期的位置，ReadInConfig() 就直接报错，掩盖了真实路径问题。
- 用
os.Stat()或os.ReadFile()显式检查每个候选路径，例如./conf/config.json→./conf/config.yaml→./conf/config.toml，读到第一个存在的就停 - 读到内容后，**必须立刻调
viper.SetConfigType("json")或viper.SetConfigType("yaml")**，不能依赖后缀——尤其当文件叫app.conf或没后缀时，viper 默认不认识 - 别把
viper.SetConfigFile("./conf/config.yaml")和viper.SetConfigName("config")混用，前者会绕过AddConfigPath()逻辑，容易导致路径解析混乱
如何实现 base / env / override 三层深合并
所谓“分段式”，本质是手动控制合并顺序：base 提供默认值，env 覆盖环境专属配置（如 dev/staging/prod），override 是运行时最高优先级（命令行参数 > 环境变量）。viper.ReadInConfig() 只能加载单个文件，三层必须拆开做。
- 先用
viper.ReadConfig(bytes.NewReader(baseData))加载基础配置，注意此时不能调ReadInConfig() - 再用
viper.MergeConfig(bytes.NewReader(envData))合并环境层——这是深合并，嵌套字段（如database.host）不会被整段覆盖，只替换对应 key -
viper.AutomaticEnv()必须在MergeConfig()之后、viper.BindPFlags()之前调用；否则环境变量值不会参与最终计算 -
viper.BindPFlags()要放在最后，因为命令行参数优先级最高；若提前绑定，flag 值可能被后续MergeConfig()覆盖 - 绝对避免用
viper.Set("key", value)手动设值——它不走 merge 流程，和深合并逻辑冲突，容易导致部分字段丢失
结构体 Unmarshal 时字段为空或类型错乱
常见现象是 viper.Unmarshal(&cfg) 后，cfg.Database.Host 还是空字符串，或者 Port 是 0。这不是 viper 的 bug，而是 Go 反射和标签规则没对齐。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 结构体字段必须首字母大写（导出），小写字段如
host string永远不会被赋值 - YAML/JSON 标签要显式写对：
Host string `yaml:"host"`或Port int `json:"port"`，不能只靠字段名自动映射 - 嵌套结构体也要导出：如果
Database DBConfig `yaml:"database"`，那DBConfig类型本身字段也得大写 - 对
time.Duration、url.URL等非原生类型，viper.Unmarshal()无法自动转换，得用mapstructure.DecodeHook注册解码器 - 别在
Unmarshal()前调viper.Get("xxx")测试——如果配置还没加载完，Get返回零值，会误导你判断字段是否生效
用 embed.FS 加载内嵌配置时 SetConfigType() 为什么必须手动调
viper.AddConfigPath() 完全不支持 embed.FS，它只查本地磁盘。直接调 viper.ReadInConfig() 必然报 Config File "config" Not Found，哪怕你确实在 //go:embed config.yaml 里声明了。
立即学习“go语言免费学习笔记（深入）”；
- 必须用
assets.ReadFile("config.yaml")（假设assets是embed.FS变量）读出[]byte - 然后传给
viper.ReadConfig(bytes.NewReader(data))，而不是SetConfigFile() -
viper.SetConfigType("yaml")必须在ReadConfig()前调，否则仍会报unknown config type——viper 不会从文件名或内容自动推断格式 - 如果项目同时支持多环境配置（如
config.dev.yaml、config.prod.yaml），建议把环境名作为变量拼进ReadFile()路径，而不是靠AutomaticEnv()自动映射，后者只影响环境变量，不干预文件读取
