Viper 配置加载需显式设置路径和 tag：必须用 SetConfigFile 或 SetConfigName+AddConfigPath 指定 YAML 路径；嵌套 struct 需 mapstructure tag 对齐 snake_case；环境变量需 AutomaticEnv()+SetEnvPrefix 才能映射；读取数组/map 应用 cast 包或专用 Get 方法。
yaml 文件路径没被 viper 正确识别
viper 默认不自动猜路径，SetConfigFile 或 SetConfigName + AddConfigPath 必须显式指定，否则会报 Config File "config" Not Found in "[.]"。常见错误是只调了 SetConfigName("config") 却忘了加路径。
-
AddConfigPath("./conf")和AddConfigPath("conf")效果不同：前者是相对当前工作目录（os.Getwd()），后者是相对执行文件所在目录（需配合os.Chdir()或用filepath.Dir(os.Executable())） - 如果配置文件在项目根目录，建议统一用
AddConfigPath(".")，再配SetConfigName("config")，并确保运行时工作目录正确 - 调试时可加
fmt.Println(viper.ConfigFileUsed())确认实际加载的是哪个文件
viper.Unmarshal 无法把嵌套字段映射到 struct
不是所有 YAML 嵌套结构都能靠 viper.Unmarshal 自动对齐——关键在 struct tag。viper 默认按字段名匹配（大小写敏感），但 YAML 键通常是 snake_case，而 Go struct 字段是 PascalCase，必须显式用 mapstructure tag 对齐。
- 错例：
Port int `json:"port"`→ viper 不认jsontag，会忽略该字段 - 正例：
Port int `mapstructure:"port"`，或更稳妥地加上mapstructure:",omitempty" - 嵌套 struct 同理：外层字段也要带
mapstructuretag，否则内层字段即使有 tag 也进不来 - 如果字段名恰好和 YAML key 一致（比如全大写或驼峰），可以不加 tag，但不推荐依赖这种巧合
环境变量覆盖 yaml 配置时行为不符合预期
viper 的覆盖优先级是：环境变量 > 命令行参数 > config file > 默认值。但默认情况下，它不会自动把环境变量名转成配置路径，比如 DB_PORT 不会自动对应 db.port，必须手动启用 AutomaticEnv() 并设置前缀。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 调用
viper.AutomaticEnv()后，还需用viper.SetEnvPrefix("APP")，这样APP_DB_PORT才能映射到db.port - 环境变量名中的下划线会被自动转为点号，但仅限于前缀之后的部分；前缀本身不参与转换
- 若同时用了
BindEnv("db.port", "APP_DB_PORT")，则优先走 bind 规则，AutomaticEnv不再干预该 key - 注意：环境变量值始终是字符串，viper 会尝试类型转换（如转 int），失败时字段保持零值，不会报错
读取数组或 map 类型配置容易 panic 或丢数据
viper 对 Get 系列方法的返回类型很敏感。直接用 viper.GetInt("ports.0") 可能 panic，因为 ports 是数组，但 viper 默认返回 interface{}，未做类型断言就强转会崩。
立即学习“go语言免费学习笔记（深入）”；
- 安全做法：先
viper.Get("ports")拿到interface{}，再用cast.ToIntSlice或cast.ToStringMap转换（需引入github.com/spf13/cast） - 或改用
viper.GetStringMapString("databases")这类专用方法，它们内部做了类型检查，返回空 map 而非 panic - YAML 中空数组
[]和空 map{}在 viper 里分别对应[]interface{}和map[string]interface{}，别用GetBool去读一个本应是 map 的字段 - 如果配置中某字段缺失，
viper.GetStringMapString("missing")返回空 map，但viper.Get("missing").(map[string]string)会 panic —— 类型断言前务必确认存在且类型匹配
YAML 解析本身不难，真正卡住人的往往是路径、tag、类型转换这三处细节。尤其是 struct 嵌套 + mapstructure tag + 环境变量前缀组合起来时，少设一个点就静默失效。多打一行 viper.AllKeys() 和 viper.Get("xxx") 看实际值，比翻文档快得多。
