VSCode 默认不校验 YAML 语法，需安装 redhat.vscode-yaml 扩展并配置 JSON Schema 关联才能实现语义级校验、补全与格式化。
VSCode 默认不校验 YAML 语法，必须安装扩展并正确配置才能实时报错、补全和格式化。
安装 YAML 官方扩展（redhat.vscode-yaml）
这是目前最稳定、功能最全的 YAML 支持扩展，由 Red Hat 维护，支持 JSON Schema 校验、自动补全、折叠、跳转定义等。
- 在 VSCode 扩展市场搜索
YAML，认准发布者为Red Hat、ID 为redhat.vscode-yaml - 安装后无需重启，但需确保当前文件关联为
YAML语言模式（右下角状态栏显示YAML；若显示Plain Text，点击它并选择YAML） - 该扩展依赖 Node.js 运行时，若提示
Failed to start client，检查系统是否已安装 Node.js（node -v可验证）
启用 schema 关联实现精准校验
纯语法检查只能发现缩进、冒号缺失等基础错误；要验证字段名、取值范围、必填项等语义级问题，必须绑定对应 JSON Schema。
- 在工作区根目录创建
.vscode/settings.json，加入如下配置：
{
"yaml.schemas": {
"./schema.json": ["/*.yaml", "/config/*.yml"],
"https://json.schemastore.org/github-workflow.json": "/.github/workflows/*.yml",
"kubernetes": "/manifests/*.yaml"
}
}-
"kubernetes"是内置快捷名，会自动匹配 Kubernetes 官方 schema；其他需填绝对路径或 URL - 路径匹配基于工作区根目录，不是文件系统绝对路径；通配符只支持
*和**，不支持正则 - 如果 schema 文件本地存在但未生效，检查文件编码是否为 UTF-8，且无 BOM
修正常见误报与补全失效问题
YAML 扩展对缩进极其敏感，且部分场景下会因语言模式识别失败而禁用全部功能。
- 确认文件以
.yaml或.yml结尾；若用.template.yaml等自定义后缀，需在settings.json中添加："files.associations": {"*.template.yaml": "yaml"} - 避免混合使用 Tab 和空格缩进；VSCode 应统一设为「Insert Spaces」，推荐缩进为 2（YAML 规范无强制要求，但多数工具链默认 2）
- 如果补全不出现，尝试按下
Ctrl+Space手动触发；若仍无效，检查是否被其他扩展（如 Prettier 单独启用了 YAML 支持）干扰 - 注释后紧跟换行可能导致解析器卡住，例如：
key: value # comment\n后直接写新字段，某些版本会跳过校验
Schema 关联是 YAML 编辑中最容易被跳过的环节，没配它，90% 的业务级错误（比如拼错 imagePullPolicy 或漏掉 spec.template.spec.containers）根本不会被标记出来。
