如何在VSCode中一键格式化并校验JSON数据格式

首页

编程语言

热心网友

转载

2026-05-01

VSCode中Shift+Alt+F对JSON文件无反应，是因为文件未被识别为JSON或JSONC模式；需点击右下角状态栏切换语言模式，并确保启用格式化与验证设置。

如何在VSCode中一键格式化并校验JSON数据格式

免费影视、动漫、音乐、游戏、小说资源长期稳定更新！ 👉 点此立即查看 👈

VSCode 里 JSON 格式化为什么按 `Shift+Alt+F` 没反应？

这事儿其实挺常见的。VSCode 有个默认规则：它不会为那些没被正确识别语言模式的文件启用格式化功能。换句话说，如果你打开的是一个没有扩展名的纯文本文件，或者后缀名不是标准的 .json（比如你给文件起名叫 config 或 data），那么 VSCode 就不会自动激活 JSON 格式化器——哪怕文件里的内容完完全全就是 JSON 格式。

解决起来并不复杂。首先，看一眼编辑器右下角的状态栏，确认那里显示的是 JSON，而不是 Plain Text 或 JSONC。如果不是，直接点击那个语言标识，选择 Configure File Association for '.xxx'，然后手动指定为 JSON。还有个更快的办法：按下 Ctrl+K M（Windows/Linux）或 Cmd+K M（macOS），然后输入 json 并回车。

这里有个细节需要注意：如果文件里包含了注释（比如 // 或 /* */），VSCode 通常会默认使用 JSONC 模式。在这种模式下，Shift+Alt+F 快捷键依然可用，但校验逻辑会宽松得多——它不会把注释当成错误标红，当然，也不会帮你把注释转换成合法的 JSON 结构。
所以，如果你需要的是严格的纯 JSON 校验（比如配置文件要求绝对规范，不能有任何注释），那就务必切换到 JSON 模式。否则，像 eslint 或 prettier 这类插件很可能会跳过对注释的检查。

如何让保存时自动格式化 + 报错不通过？

VSCode 本身只负责“格式化”这个动作，它并不内置严格的语法校验功能。也就是说，它能把代码排整齐，但不会主动用红色波浪线标出 Unexpected token 这类语法错误。想要实现“保存时自动格式化，并且有错误就报出来”的效果，通常需要插件和设置的组合拳。

一个比较推荐的组合是使用 ESLint 插件并配合项目级配置。当然，也有更轻量的方案：直接启用 VSCode 内置的 JSON 验证器，这不需要安装额外插件。

首先，确保设置项 "json.validate.enable": true 是开启的（默认就是开启状态，可以在 settings.json 里确认一下）。

然后，在用户设置或工作区设置里加入这几行：

"editor.formatOnSa ve": true,
"editor.codeActionsOnSa ve": {
  "source.fixAll": true
}

需要特别提醒的是：source.fixAll 这个操作对 JSON 文件通常是无效的，因为它依赖于语言服务器的深度支持。对于 JSON 文件，所谓的“修复”基本就等同于“重新格式化”，真正的语法错误还是得靠开发者手动去修正。

`prettier` 和内置 JSON 格式化器有啥区别？

这可能是很多开发者会纠结的问题。VSCode 自带的 JSON 格式化器（由 TypeScript 语言服务提供）严格遵守 JSON 规范，除了缩进空格数，几乎不支持任何自定义选项（比如把双引号换成单引号，或者在末尾添加逗号）。而 prettier 作为一个通用的代码格式化工具，对 JSON 的支持其实有一些限制：

prettier 默认情况下是不处理 .json 文件的，除非你在它的配置文件（比如 prettier.config.js）里明确启用：
```
module.exports = {
  "overrides": [
    { "files": "*.json", "options": { "tabWidth": 2 } }
  ]
}
```
即便你启用了，prettier 也会断然拒绝格式化那些包含注释的 .json 文件（它会直接报错 Unexpected comment）。相比之下，VSCode 内置的格式化器在 JSONC 模式下，就能安全地处理带注释的文件。
从性能角度看，内置格式化器速度更快，几乎没有启动延迟。而 prettier 需要加载 Node.js 环境，对于小文件来说差异不大，但如果遇到体积较大的 JSON 文件（比如超过 1MB），就可能感觉到明显的卡顿。

遇到 `Invalid JSON: Unexpected token` 却找不到哪错了？

这种错误最让人头疼，往往是因为一些不可见的字符在作祟。比如从网页上复制 JSON 时，可能夹带了零宽空格（\u200b）、中文引号（“”），或者是 Windows 和 Unix 系统换行符（\r\n 和 \n）混用。VSCode 默认不会高亮显示这些特殊字符。

可以试试下面这几个快速定位的方法：

按下 Ctrl+Shift+P 打开命令面板，运行 Toggle Render Whitespace 命令，这样就能看到所有空格和控制符的显示，排查是否有异常。
直接把内容粘贴到在线的 jsonlint.com 这类校验网站，它能精确地指出错误发生在第几行第几列。
在 VSCode 中安装 Highlight Bad Chars 这类插件，它能自动标红非 ASCII 空格、全角符号等非法字符。
如果错误提示出现在第一行的第一个字符，那大概率是文件开头存在 UTF-8 BOM 头（字节顺序标记，即 EF BB BF）。这时，可以通过命令面板运行 Change File Encoding → Sa ve with Encoding → 选择 UTF-8（无 BOM）来解决问题。