怎样在VSCode中编辑JSON Schema并自动验证？【教程】

vscode通过$schema字段实现jsON编辑即验证，需确保文件为json语言模式、$schema指向合法URI且Schema语法正确；编辑Schema文件时须手动设为“JSON Schema”模式或加注释触发识别。

VSCode 本身不内置 JSON Schema 编辑器，但通过合理配置扩展和 $schema 字段，可以实现「编辑即验证」——只要 JSON 文件声明了合法的 Schema 地址，保存时就能实时报错、补全、悬停提示。

怎么让 VSCode 识别并加载 JSON Schema？

关键不是“编辑 Schema”，而是让 JSON 实例文件关联到 Schema。VSCode 通过 $schema 字段自动绑定验证规则：

• $schema 必须是字符串，且值为可解析的 URI（本地路径用 file://，远程用 https://）
• 本地 Schema 文件路径需绝对（相对路径在 VSCode 中常失效），例如："$schema": "file:///Users/me/schemas/config.schema.json"
• 如果 Schema 存在语法错误（比如多逗号、引号不闭合），VSCode 会静默忽略它，不报错也不验证——这是最常被忽略的失败原因
• VSCode 内置 JSON 支持默认启用，无需额外安装插件，但必须确保文件后缀是 .json 或 jsonc（否则语言模式不对，$schema 不生效）

如何编辑 JSON Schema 文件本身并获得提示？

编辑 xxx.schema.json 时，VSCode 默认把它当普通 JSON，不会自动提供 Schema 元字段补全（如 type、properties）。要获得智能支持，需手动设置语言模式：

• 打开 Schema 文件 → 点击右下角语言标识（如 “JSON”）→ 选择 “JSON Schema”（不是 “JSON”）
• 或在文件顶部加注释触发识别：// @schema: http://json-schema.org/draft-07/schema#
• 此时 type、required、enum 等字段会有补全和校验；但注意：VSCode 自带的 Schema 支持只覆盖 draft-04 / 06 / 07，draft-2019-09 及以后版本可能缺失部分关键字提示

为什么修改后没验证？常见断点排查

验证失效往往卡在中间环节，而不是配置本身：

• 检查当前文件的语言模式是否为 JSON（不是 Plain Text 或 JSON with Comments）：快捷键 Ctrl+Shift+P → 输入 “Change Language Mode” 确认
• 打开命令面板（Ctrl+Shift+P），运行 “Developer: Toggle Developer Tools”，在 console 里搜 schema 或 json，看是否有加载失败日志（如 Failed to load schema from file://...）
• 如果用的是自定义 Schema，确认它本身符合 JSON Schema 规范（可用 jsonschemalint.com 快速验证）
• VSCode 的 JSON 验证是“懒加载”的：只有光标进入某个字段、或保存文件时才触发，不会持续扫描整个文档

真正麻烦的不是配置，而是 Schema 文件路径写错、语言模式没切对、或者把 .schema.json 当成普通 JSON 打开——这三处出问题，验证就完全静音，连错误提示都不会出现。