viper原生不支持多格式fallback加载，必须手动按顺序检查文件并显式调用setconfigtype()和readconfig()；因其仅硬编码识别.json/.yaml/.toml等后缀，对config.conf、无后缀文件或embed.fs字节流均无法自动推断类型，且setconfigtype()必须在readconfig()前调用。
直接用 viper.ReadInConfig() 加载多格式配置文件，不显式设置类型和路径，90% 会失败——不是文件不存在，就是报 unknown config type 或 Config File Not Found。
为什么 viper.ReadInConfig() 总是报 unknown config type
Viper 不会猜你给的是什么格式。它只对极少数后缀硬编码识别：.json、.toml、.yaml、.yml、.properties、.env、.env.yaml。其余一概无视。
- 文件叫
config.conf、app.yml（注意是.yml而非.yaml）、settings（无后缀）→ 必须提前调viper.SetConfigType("yaml") - 用
embed.FS读字节流再传给viper.ReadConfig(bytes.NewReader(data))→SetConfigFile完全无效，SetConfigType是唯一出路 - 类型名必须严格小写：
"json"可以，"JSON"会失败；"yaml"稳定，"yml"在部分版本里能蒙混但不保证 -
SetConfigType()必须在ReadInConfig()或ReadConfig()之前，且不能晚于SetConfigName()和AddConfigPath()
如何让 Go 微服务同时支持 config.json 和 config.yaml 并按优先级加载
Viper 原生不支持“先找 A，找不到再找 B”。ReadInConfig() 只走一次查找逻辑，依赖 SetConfigName() + AddConfigPath() 的组合，最终只加载第一个匹配项。
- 手动按顺序检查：
os.ReadFile("config.json")→ 成功就viper.SetConfigType("json")+viper.ReadConfig()；失败再试config.yaml - 别把路径硬编码进
AddConfigPath()后指望它自动扫多个后缀——它不会扫描，只拼path + "/" + name + "." + type - 若需运行时切换（比如测试用 JSON，生产用 YAML），把格式存进 flag：
flag.String("config-type", "yaml", "config file type")，然后viper.SetConfigType(*configTypeFlag)
viper.AddConfigPath() 在 embed.FS 下为何完全失效
AddConfigPath() 只操作本地文件系统（os.Open），对 embed.FS、io/fs.FS 或任何抽象文件系统零感知。直接调 ReadInConfig() 必然报 Config File Not Found。
- 正确做法：用
embed.FS读取后转*bytes.Reader，再喂给viper.ReadConfig() - 示例：
viper.SetConfigType("yaml")→viper.ReadConfig(bytes.NewReader(data)) - 漏掉
SetConfigType？照样报unknown config type，哪怕内容是合法 YAML
嵌套字段取值和热重载的两个易踩坑点
viper.GetString("database.host") 看似方便，但一旦 database 是 map 类型，它会静默返回空字符串，而不是 panic 或 error。
- 安全写法：用
viper.Sub("database")分层获取子对象，再调GetString("host") - YAML 中的
timeout: 30默认反序列化为float64，要用GetInt()，不是GetInt32() -
viper.WatchConfig()内部启 goroutine 监听文件变化，但不会自动 stop。多次调用（如测试中反复初始化）会导致 goroutine 泄漏
最常被忽略的一点：所有 SetConfigType() 调用必须在 ReadInConfig() 或 ReadConfig() 之前，且不能晚于 SetConfigName() 和 AddConfigPath() —— 这个顺序错一次，整个加载链就断了。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
