VSCode 的 hover 不显示 JSON 校验错误,因其仅提供结构化数据预览,而语法诊断由独立 validation pipeline 处理并输出至 Problems 面板和行内波浪线。

VSCode 本身不支持在悬浮提示(hover)中显示 JSON 格式校验结果——校验错误(如 Unexpected token、Missing comma)只通过编辑器内联波浪线 + 问题面板(Problems tab)呈现,hover 不会注入语法错误信息。
为什么 hover 里看不到 JSON 校验提示
JSON 语言服务的 hover 提供的是结构化数据预览(比如展开对象字段、数组长度、字符串值截断),而非语法诊断。校验逻辑走的是独立的 validation pipeline,和 hover provider 完全解耦。
- hover 触发时,VSCode 调用
provideHover,返回的是当前光标位置的语义信息(如键名、值类型、嵌套层级) - 语法错误属于 parser 阶段的 diagnostics,由
json.validate.enable控制,输出到 Problems 面板和行内红线,不参与 hover 渲染 - 即使你把光标悬停在报错的逗号缺失处,hover 仍只显示该 token 的原始文本或空内容,不会叠加错误描述
能间接“看到”JSON 结构信息的 hover 场景
虽然不显示校验错误,但以下情况 hover 会真实反馈 JSON 数据结构,前提是文件被识别为 JSON 或 JSONC 模式:
KeystoneJS 是一个功能强大的开源无头 CMS,适用于 Node.js,它根据您的模式定义自动生成 GraphQL API 和基于 React 的管理界面。由 Thinkmill 构建,支持 PostgreSQL 和 SQLite、自定义访问控制、钩子、虚拟字段和基于文档的富文本编辑。
- 悬停在对象键上:显示
"name": string这类类型推导(仅限简单字面量,不涉及 schema) - 悬停在数组元素上:显示索引位置和值类型,例如
[0]: { "id": number, "title": string } - 悬停在字符串值上:显示截断后的实际内容(默认最多 100 字符),方便确认是否含不可见字符
- 若已关联
json.schemas,且光标落在有$schema定义的顶层对象上,hover 可能显示 schema 来源链接(非错误)
想快速定位 JSON 校验失败点?别依赖 hover
真正有效的做法是结合状态栏提示与快捷操作,而不是等待 hover 出现错误:
- 右下角状态栏出现红色感叹号图标 → 点击它,直接跳转到第一个校验错误行
- 按
Ctrl+Shift+M(Windows/Linux)或Cmd+Shift+M(macOS)打开 Problems 面板,筛选json类型错误 - 错误信息里带具体位置(如
line 42, column 15),比 hover 的模糊悬停更准 - 若整段 JSON 变灰或无高亮,大概率是开头有 BOM(
\uFEFF)或零宽字符,此时 hover 也为空——需用正则/[\u200b-\u200f\ufeff]/g清理
最易被忽略的一点:哪怕你装了 Prettier、ESLint 或自定义 hover 插件,它们也无法让 hover 显示 JSON 语法错误。这不是配置遗漏,而是 VSCode 架构决定的——校验(diagnostics)和悬停(hover)属于两条完全分离的语言服务通道。










