viper 默认不支持 yaml，需显式注册解析器并调用 viper.setconfigtype("yaml")（配合 setconfigname 时必需），否则 readinconfig() 报“unsupported config type”错误。
Viper 默认不支持 YAML，必须显式注册解析器，否则 viper.ReadInConfig() 会报 “Unsupported Config Type” 错误。
为什么 viper.ReadInConfig() 读不到 YAML 文件
Viper 从 v1.12.0 开始移除了对 YAML 的默认支持，即使你 import 了 "gopkg.in/yaml.v3"，也不代表 Viper 能自动识别 .yaml 后缀。它只在内部注册表里查“文件扩展名 → 解析函数”的映射，而这个映射默认为空。
常见错误现象：viper.ReadInConfig(): Unsupported Config Type "" 或 Config File "config" Not Found in "[.]"（其实是找到了但解析失败）。
- 确认配置文件路径正确，且
viper.SetConfigFile("config.yaml")或viper.SetConfigName("config")+viper.AddConfigPath("./conf")已设置 - 必须手动调用
viper.SetConfigType("yaml")（仅当用bytes或io.Reader加载时才需要） - 更稳妥的做法：用
viper.Unmarshal(&cfg)前确保viper.ReadInConfig()成功返回 nil
正确加载 YAML 配置的三步操作
不是加个 import 就完事，得让 Viper “认出” YAML 并“学会怎么拆”。核心是注册解析器 + 显式指定类型（或后缀）。
- import
"gopkg.in/yaml.v3"（v3 是主流，v2 不兼容 Go 1.21+） - 在
main()开头执行：viper.SetConfigType("yaml")（如果用SetConfigFile指定了带后缀的路径，这步可省；但如果用SetConfigName，就必须设） - 调用
viper.ReadInConfig()前，确保已通过viper.AddConfigPath()添加了搜索路径，且文件存在、可读
示例片段：
viper.AddConfigPath("./conf")
viper.SetConfigName("app")
viper.SetConfigType("yaml") // 关键！尤其配合 SetConfigName 时
err := viper.ReadInConfig()
if err != nil {
log.Fatal(err) // 别忽略这个 err
}
viper.Unmarshal() 和 viper.Get() 的行为差异
YAML 结构嵌套深时，viper.Get("server.port") 返回 interface{}，类型断言容易 panic；而 viper.Unmarshal(&cfg) 直接绑定到 struct 字段，类型安全、字段名匹配靠 tag（如 `mapstructure:"port"`）。
- struct 字段必须首字母大写（导出），否则
Unmarshal无法赋值 - YAML 中的
redis-url这种带连字符的 key，需用mapstructure:"redis-url"tag 显式绑定 -
viper.Get()对 map 或 slice 类型返回的是interface{}，需用viper.GetStringMapString()等专用方法取值，否则运行时报 panic
测试 YAML 加载是否真正生效的快速验证法
别等启动服务才发现配置没读进去。加一行调试输出最直接：
fmt.Printf("Loaded config: %+v\n", viper.AllSettings())
这行代码能打印出所有已解析的键值（包括嵌套结构），一眼看出 key 名是否和 YAML 一致、缩进是否导致层级丢失、布尔值是否被错读成字符串（YAML 的 true / on / yes 都会被转成 bool，但 "true" 是字符串）。
特别注意：YAML 中用空格缩进，不能用 Tab；顶层 key 后面要跟冒号和空格（log_level: debug），少空格会导致解析成字符串字面量而非键值对。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
