viper.GetString("key")返回空字符串，90%因YAML解析失败：字符串未加引号（如含数字、连字符、斜杠时被误判为null/bool）、路径未正确设置（AddConfigPath(".")指当前工作目录而非项目根目录）、大小写/缩进错误或嵌套字段缺失mapstructure tag。
直接说结论：viper.GetString("key") 返回空字符串，90% 不是代码写错了，而是 config.yaml 里那行值没被正确解析——要么 YAML 语法踩坑，要么路径没对上，要么大小写/引号/缩进悄悄搞了鬼。
YAML 字符串值必须加引号，尤其含数字、连字符或斜杠时
YAML 解析器会把 API_TRACKING_ID: 77xxx1 当成整数或 null，不是字符串。它不关心你“想”存什么，只按 YAML 规则推断类型。
- ❌ 错误写法：
API_TOKEN: abc-def-123→ 被识别为 boolean false（因含连字符且无引号） - ❌ 错误写法：
URL: https://api.example.com→ 被识别为 null（因含冒号和斜杠） - ✅ 正确写法：
API_TOKEN: "abc-def-123"、URL: "https://api.example.com" - ⚠️ 注意：即使全字母小写如
env: production，也建议统一加双引号，避免未来加数字或符号时翻车
viper.AddConfigPath(".") 不等于“项目根目录”，而是当前工作目录
运行 go run main.go 时，viper.AddConfigPath("."); viper.SetConfigName("config") 查找的是 os.Getwd() 返回的路径，不是 main.go 所在目录，更不是 go.mod 所在目录。
- 调试必做：
fmt.Println("Loaded:", viper.ConfigFileUsed())—— 看见输出路径才能确认到底读了哪个文件 - 如果配置文件固定在项目根目录，但你常从子目录运行命令，就别用
"."，改用：viper.AddConfigPath(filepath.Dir(os.Args[0]))（需 import"path/filepath"和"os"） - 多个路径可叠加：
viper.AddConfigPath("/etc/myapp")+viper.AddConfigPath(".")，viper 会从左到右查找第一个存在的config.yaml
嵌套字段读取失败？检查 struct tag 是否用了 mapstructure 而非 json
viper.Unmarshal() 默认不认 json tag，只认 mapstructure。YAML 键名是 server.port，Go struct 字段叫 Port，中间没桥接，字段就永远是零值。
立即学习“go语言免费学习笔记（深入）”；
- ❌ 错误结构体：
Port int `json:"port"`→ 字段不会被填充 - ✅ 正确写法：
Port int `mapstructure:"port"` - 嵌套结构也要 tag：
Database DatabaseConfig `mapstructure:"database"`，否则内层mapstructure:"user"无效 - 如果字段名恰好和 YAML key 完全一致（比如都叫
API_TOKEN），可以不加 tag，但别依赖这个——YAML 习惯用 snake_case，Go 习惯 PascalCase，早晚要对齐
GetString 返回空，但实际值存在？优先查大小写和空格
viper 的键匹配严格区分大小写，且忽略前后空白，但 YAML 缩进错误会导致整个层级被跳过。
- YAML 中
server:后面若少缩进一个空格，port: 8080就不属于server，viper.GetInt("server.port")必然返回 0 - YAML 键名写成
ServerPort，代码却写viper.GetString("server.port")→ 不匹配，返回空 - 用
viper.AllKeys()打印所有已加载的键，一眼看出实际结构是否符合预期：fmt.Printf("Keys: %+v\n", viper.AllKeys()) - YAML 不允许 tab 缩进，只认空格 —— 用编辑器设为 “显示不可见字符”，确认没混入 tab
最易被忽略的点：YAML 的「类型自动推断」和 Go 的「零值静默」合谋掩盖问题。一个没引号的 77xxx1 在 YAML 层就被当成 null，viper 层看到的就是空，而 GetString 对 null 返回空字符串，不报错也不警告。所以别等 runtime 出问题，先盯死 config.yaml 的每一行引号和缩进。
