viper已内置多种格式解析能力，关键在正确配置路径、类型和结构体标签；需显式添加配置路径、设置文件名或完整路径、使用mapstructure标签、显式指定类型，并启用debug模式排查问题。
直接用 Viper，别自己写解析器——它已经内置了 JSON、YAML、TOML、INI 的解析能力，关键在初始化时配对路径、类型和结构体标签。
为什么 viper.ReadInConfig() 总报 “config file not found”
不是文件真丢了，而是 Viper 默认只在当前工作目录（os.Getwd()）里找，不进子目录，也不向上递归。CI/CD 容器里 os.Getwd() 往往是 / 或临时路径，静默失败很常见。
- 必须显式调用
viper.AddConfigPath("./config")或viper.AddConfigPath(".") - 再配
viper.SetConfigName("config")（注意：不带后缀！） - 如果用了完整路径+后缀，比如
./config/config.yaml，就得改用viper.SetConfigFile("./config/config.yaml")，此时AddConfigPath和SetConfigName会被忽略 - 支持多次调用
AddConfigPath，Viper 会按添加顺序从前往后查找第一个匹配的文件
viper.Unmarshal() 后结构体字段全是零值
典型现象：YAML 写的是 database: {host: "127.0.0.1", port: 5432}，但 Go 结构体字段始终为空字符串或 0。
- 字段必须导出（首字母大写），否则
mapstructure解析器无法访问 - 嵌套结构避免用匿名字段，例如
DB struct{}不稳定；应改为DB DBConfig显式命名 - 必须加
mapstructure标签，如Host string `mapstructure:"host"`；仅用yaml:"host"不生效（Viper 默认走mapstructure，不是原生 YAML 标签） - 若字段可能为空，建议设默认值，或用指针类型（如
*string）配合viper.SetDefault()
如何让同一份代码自动适配 JSON/YAML/TOML/INI
Viper 不靠文件后缀自动切换解析器，它只认你最后一次 SetConfigType() 或 SetConfigFile() 隐含的类型。依赖后缀推断不可靠（比如 .conf 根本无法识别）。
- 用
SetConfigName + AddConfigPath时，必须配viper.SetConfigType("yaml")，否则读config.toml会按 YAML 解析并 panic - 用
SetConfigFile("./config.toml")时，Viper 会从后缀猜类型，但这个行为不稳定，仍建议显式SetConfigType("toml") - INI 格式需额外注意：不支持点号嵌套键名（
db.host会被当作文本字面量），必须用节（section）方式：[db]\nhost = "127.0.0.1" - 多格式混用时，加载顺序不变（命令行 > 环境变量 > 配置文件 > 默认值），但不同格式对空值、注释、缩进容忍度差异极大——YAML 缩进错一位、TOML 数组未闭合、INI 等号前后多空格，都可能导致整个文件加载失败且报错模糊
上线前最容易被忽略的一件事
不同格式配置文件的语法容错性天差地别，而 Viper 默认错误提示非常简略。上线前务必在启动时加一句 viper.Debug()，它会打印实际加载了哪些键、来源是哪个文件、值是什么——很多“字段没生效”的问题，一眼就能看出是某层配置被覆盖，或是某个格式根本没加载成功。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
