Viper无法自动fallback多格式配置文件，因其只按AddConfigPath顺序加载首个匹配文件且不遍历后缀；必须手动用os.ReadFile依次检查config.json→yaml→toml并显式SetConfigType，再调ReadConfig加载。
为什么直接用 viper.ReadInConfig() 加载多格式会失败
因为 viper 默认只在当前工作目录找 config 文件，且不自动遍历后缀。你放了 config.yaml 和 config.json 在同一目录，它不会“智能 fallback”，而是按 AddConfigPath 顺序扫描，找到第一个就停——哪怕你本意是优先 YAML。
常见错误现象：viper.ReadInConfig() 报 "Config File Not Found"，其实文件存在，只是路径没加对；或者加载了 JSON 却用 YAML 语法写，导致解析 panic。
- 必须显式调用
viper.AddConfigPath("./config")（或绝对路径） - 若用
SetConfigName("config")，就得配viper.SetConfigType("yaml")，否则默认按 JSON 解析 - 若用
SetConfigFile("./config/config.toml")，viper 会尝试从后缀猜类型，但.conf、.cfg这类无明确后缀的文件会失败 - CI/CD 容器里
os.Getwd()往往是/，不设路径基本必挂
如何手动实现 config.json → config.yaml → config.toml 的 fallback 加载
靠 viper 自身做不到，得自己用 os.ReadFile 控制顺序。关键不是“读哪个”，而是“读到就停，并立刻告诉 viper 这是什么格式”。
示例逻辑：
立即学习“go语言免费学习笔记（深入）”；
for _, ext := range []string{"json", "yaml", "toml"} {
path := fmt.Sprintf("./config/config.%s", ext)
if _, err := os.Stat(path); err == nil {
data, _ := os.ReadFile(path)
viper.SetConfigType(ext) // 必须显式设类型
viper.ReadConfig(bytes.NewReader(data))
break
}
}
- 别用
viper.WatchConfig()替代初始化 fallback——那是热重载，不是首次加载 - 如果配置文件名不固定（比如
app.conf），就不能依赖后缀，得靠bytes.HasPrefix或简单内容嗅探（如开头含---就当 YAML） - 读到内容后，
viper.ReadConfig()比ReadInConfig()更可控，它不查路径，只解码传入的字节流
struct tag 不一致时 unmarshal 总是零值怎么办
字段全为零值，不是文件没读到，而是 struct tag 写错了或字段未导出。Go 的 json.Unmarshal、yaml.Unmarshal、toml.Decode 全部只处理首字母大写的导出字段，且严格匹配 tag 名。
-
Port int `json:"port"`和Port int `yaml:"port"`必须同时存在，不能只写一个 - 嵌套结构体不用
inline时，YAML 的db: {host: ...}必须对应DB DBConfig `yaml:"db"`，不能写成DB struct{...} `yaml:"db"` - INI 格式不支持点号嵌套，
db.host = 127.0.0.1会被当作文本，得用[db]节 +host = ... - 字段类型要和配置值能对上：YAML 的
true是 bool，"true"是 string，别混用
viper.Unmarshal() 后 mapstructure 标签缺失导致字段丢失
这是最隐蔽的问题：viper 底层用 mapstructure 把键值映射到 struct，但它不认 json: 或 yaml:，只认 mapstructure:。如果你只写了 Port int `json:"port"`，viper 就找不到这个字段。
- 正确写法是：
Port int `mapstructure:"port" json:"port" yaml:"port" toml:"port"` - 如果结构体字段名和配置 key 完全一致（如
Port对应port），可以省略 tag，但大小写必须严格匹配（port≠Port） - 匿名嵌入字段（如
DBConfig）不会自动继承外层 tag，必须显式加mapstructure:",squash" - 调试时开
viper.Debug()，看它实际解析出哪些 key，再比对 struct 字段名和 tag
]、INI 等号前后多空格，都可能让整个文件静默失效，且错误提示模糊。上线前务必用真实配置跑一遍 viper.Debug() 输出。 
