先看右下角语言模式，若显示Plain Text则非YAML语法识别问题；应点击切换为YAML，并配置"files.associations": {"*.yml": "yaml"}确保后缀识别，再检查缩进、冒号、引号等基础语法错误。
VSCode 里 YAML 配置文件没高亮，怎么快速确认是不是语法问题
不是所有“没高亮”都是配置写错了，但多数时候是 VSCode 没识别成 YAML，或者文件本身有非法缩进/冒号/引号。先别急着改 application.yaml，打开它右下角看语言模式——如果显示的是 Plain Text 或 Conf，那高亮根本不会触发。
解决路径很直接：
- 点击右下角语言标识（比如写着 “Plain Text”），输入
YAML并选中YAML（不是YAML (JSON)或其他变体） - 保存文件，VSCode 会自动应用语法校验：错误缩进、缺失冒号、键名后多空格、字符串未闭合引号，都会标红提示
- 注意：Viper 读取
.yml和.yaml都行，但 VSCode 默认只对.yaml关联 YAML 语言；若用.yml，需手动在settings.json中加"files.associations": {"*.yml": "yaml"}
viper.SetConfigType("yaml") 但读取失败，常见报错和定位方法
最典型错误是 viper.ReadInConfig(): Config File "application" Not Found in "[.]"，这说明 Viper 根本没找到文件，跟语法无关。但一旦文件被找到却解析失败，报错会明确指向行号，比如：
yaml: line 5: did not find expected key
这类错误基本锁定在以下几处：
-
server:后面的子字段（如port:）必须严格缩进 2 空格，不能用 Tab，也不能缩进 4 空格混用 - 带特殊字符的值（如密码含
@、:）必须用双引号包裹：password: "admin@123"，否则 YAML 解析器会误判为 URI 结构 - 布尔值不要写成
true/false字符串，Viper 会转成 bool 类型；但如果写成"true"（带引号），就变成 string，后续viper.GetBool()会返回 false - 注释只能用
#，且必须独占一行或位于行尾；//是无效的，会导致解析中断
配置热加载时 YAML 文件修改后不生效，怎么验证是否真 reload 了
Viper 的 viper.WatchConfig() 不会自动刷新已取值的变量，它只通知“配置变了”。你得自己注册回调函数，并在里面重新调用 viper.GetXXX() 获取新值。
容易忽略的关键点：
- 回调函数里不能只打印日志，必须显式重取值，例如：
port := viper.GetInt("server.port")，否则 Gin 启动端口还是旧的 - Watch 依赖 fsnotify，Windows 下对网络盘、WSL2 文件系统支持不稳定；开发时建议把 config 目录放在本地 NTFS 路径下
- 修改 YAML 后保存，VSCode 可能启用“延迟写入”，导致 fsnotify 拿到空文件；可临时关闭 VSCode 的
files.autoSave，改为手动 Ctrl+S - Gin 的
router.Run()是阻塞调用，Watch 回调必须在Run()前注册，否则永远不会执行
为什么用 viper.GetString("datasource.host") 返回空字符串
这不是 bug，而是 YAML 键路径匹配失败的典型表现。Viper 查找键时区分大小写，且不自动展开嵌套结构。
检查这几项：
- 确认 YAML 里写的真是
datasource:，不是dataSource:或DataSource:—— Go struct tag 和 YAML key 是两回事，Viper 只认 YAML 原始 key - 确保
viper.AddConfigPath()指向的是包含application.yaml的父目录，不是文件所在目录；例如文件在./config/application.yaml，则AddConfigPath("./config")，而非AddConfigPath("./config/application.yaml") - 调用
viper.ReadInConfig()后，用viper.AllKeys()打印所有已加载的 key，看datasource.host是否在列表里；不在就说明路径或格式有问题 - 如果 YAML 用了锚点（
&common）或引用（*common），Viper 默认不支持，需要额外启用viper.SetConfigType("yaml")后再调用viper.Unmarshal()才能正确解析复杂结构
viper.AllKeys() 输出和 VSCode 右下角的语言模式。 
