VSCode 自带 JSON 支持,无需插件即可格式化、校验和查询路径;需确保语言模式为 JSON 或 JSON5,启用保存时格式化,利用大纲视图、符号搜索和悬停提示高效编辑。

VSCode 自带对 JSON 的良好支持,无需额外插件就能完成格式化、语法校验和路径查询等常用操作,关键在于用对功能和快捷键。
自动格式化 JSON 文件
保存时自动美化结构,让嵌套层级清晰可读。确保文件类型识别为 JSON(右下角显示 JSON,不是 Plain Text);若未识别,点击右下角语言模式,选择 JSON 或 JSON with Comments。
- 手动触发:按 Shift + Alt + F(Windows/Linux)或 Shift + Option + F(macOS)
- 保存即格式化:在设置中搜索 format on save,勾选 Editor: Format On Save
- 如格式化后缩进异常,检查设置里的 Editor: Tab Size(推荐设为 2)和 Editor: Insert Spaces(建议开启)
实时语法校验与错误定位
VSCode 会在编辑时高亮语法错误(如逗号遗漏、引号不闭合、尾随逗号误用),错误信息直接显示在底部状态栏和问题面板(Ctrl+Shift+M)。
- 常见报错示例:"Expected a comma or closing brace" 多因对象末尾多写了逗号,或漏了 } / ]
- JSON5 模式(支持注释、单引号、无引号键名)需手动切换语言模式为 JSON5,否则仍按标准 JSON 校验
- 校验不通过时,保存文件会失败,并弹出提示 —— 这是保护机制,不是 bug
快速查询 JSON 路径(Key 跳转与结构浏览)
VSCode 原生不显示完整 JSONPath,但可通过折叠/展开、大纲视图和鼠标悬停高效定位字段。
- 打开大纲面板(Ctrl+Shift+O),JSON 文件会以树形列出所有顶层 key,点击即可跳转
- 按 Ctrl+Shift+P 输入 Go to Symbol in File,输入 key 名快速搜索(支持驼峰/下划线模糊匹配)
- 鼠标悬停在任意 key 上,会显示其完整路径(如 config > features > enableTelemetry),前提是 JSON 结构合法且已解析成功
- 需要真正 JSONPath 表达式(如 $..name)?可安装插件 JSONPath Online Evaluator 或配合命令行工具 jq
基本上就这些。VSCode 的 JSON 工具不复杂但容易忽略细节,配好设置后,日常编辑效率提升明显。










