必须安装redhat.vscode-yaml插件并配置yaml.schemas,否则仅支持基础语法高亮,无法校验字段拼错、漏字段等语义错误;需禁用冲突插件、重载窗口、确认语言模式为YAML,并确保schema路径匹配且编码为UTF-8无BOM。

装对插件、配好 yaml.schemas,YAML 文件才能真正“被校验”——否则你看到的只是缩进高亮,imagePullPolicy: Alaways 这种拼错值、spec.template.spec.containers 漏字段,全都不会报错。
必须安装 redhat.vscode-yaml,禁用所有冲突插件
VSCode 1.86+ 虽带基础 YAML 支持,但会和非 Red Hat 插件抢语言服务器,导致补全失效、悬停无响应,甚至 yaml-language-server 连接拒绝。
- 在扩展市场搜
Red Hat YAML,认准发布者为 Red Hat、ID 为redhat.vscode-yaml - 安装后执行
Cmd+Shift+P→ 输入Developer: Reload Window重载窗口 - 打开扩展视图,禁用所有名称含
YAML Tools、YAML Validation、Auto Close Tag的插件 - 右下角状态栏确认当前文件语言模式是
YAML(不是Plain Text),否则点击切换
不配 yaml.schemas,就等于没校验
没配 yaml.schemas,插件只会检查冒号、缩进、引号等基础语法;Kubernetes 字段名、GitHub Actions 的 on.push.branches 是否合法——全都不会校验。
使用ydata-profiling(前身为pandas-profiling)生成全面的数据质量报告,包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
- 在工作区根目录创建
.vscode/settings.json,写入:{ "yaml.schemas": { "kubernetes": "**/*.yaml", "https://json.schemastore.org/github-workflow.json": "/.github/workflows/*.yml" } } -
kubernetes是内置快捷名,自动拉官方最新 Schema;远程 URL 必须返回 HTTP 200,若网络受限,改用本地 Schema 文件路径(如"./schema/k8s.json": ["k8s/*.yml"]) - 路径匹配基于工作区根目录,
*表示单层通配,**表示递归,不要写绝对路径或正则 - 本地 Schema 文件编码必须是 UTF-8 无 BOM,否则静默失败,控制台也无报错
JSON 校验要小心 language mode 和注释陷阱
VSCode 对 JSON 的校验行为高度依赖右下角显示的语言模式:JSON 模式严格拒绝注释;JSONC 模式允许注释但跳过部分语义检查——很多团队误以为“能格式化=已校验”,结果上线后因注释未被清除而解析失败。
- 打开 JSON 文件后先看右下角:若显示
Plain Text或JSONC,点击它 → 选择Configure File Association for '.xxx'→ 设为JSON - 在
.vscode/settings.json中配置:"json.schemas": [ { "fileMatch": ["package.json"], "url": "https://json.schemastore.org/package.json" } ] - 如果文件含
//或/* */注释且你希望保留,必须用JSONC模式;但 CI 中的jq或eslint仍会因注释失败——注释不是 JSON 标准的一部分
最容易被忽略的是:Schema 绑定路径是否真匹配到你的文件,以及语言模式是否被其他插件悄悄覆盖。哪怕只差一个斜杠、一个星号层级,或者右下角显示的是 JSONC 而非 JSON,校验就会静默失效。

















