VSCode默认支持JSON格式化，无需插件，但需确保文件后缀为.json且语言模式为JSON而非Plain Text或JSON with Comments；常见问题包括格式化选项灰显、快捷键无效，主因是语言模式错误或语法不合法（如单引号、注释、未转义字符）。
JSON格式化在VSCode里默认就能用
只要文件后缀是 .json，且没被其他扩展干扰，VSCode自带的JSON语言支持会自动启用格式化功能。不需要装额外插件，也不用改设置——前提是文件没被识别成纯文本或别的语言模式。
常见错误现象：Format Document 灰掉、右键菜单里没有“格式化文档”、按 Shift+Alt+F 没反应。大概率是当前编辑器右下角显示的语言模式不是 JSON，而是 Plain Text 或 JSON with Comments（后者不被默认格式化器支持）。
- 点右下角语言标识（比如“Plain Text”），选
JSON—— 不要选JSON with Comments - 如果文件无后缀或后缀不标准（如
.config），手动切语言模式是最直接的办法 - 确认
"json.format.enable": true在设置里是开启状态（默认就是true，极少被关）
快捷键和命令行调用方式
VSCode格式化JSON不依赖外部工具，走的是内置语言服务，所以快、稳、不报错。但得用对触发方式，否则容易以为“没反应”。
- 保存时自动格式化：打开
"editor.formatOnSave"，再确保该文件关联了JSON语言模式 - 手动格式化：快捷键
Shift+Alt+F（Windows/Linux）或Shift+Option+F（macOS） - 命令面板调用：
Ctrl+Shift+P→ 输入Format Document→ 回车 - 注意：
Ctrl+K Ctrl+F是格式化选中代码块，对JSON全文件无效（它依赖缩进规则，而JSON无缩进语义）
缩进空格数和换行控制
VSCode默认用2个空格缩进JSON，但这个值可改，且只影响格式化输出，不影响语法正确性。真正容易踩坑的是换行和末尾逗号。
- 缩进宽度由
"editor.tabSize"控制（全局）或"json.tabSize"（仅JSON）决定，设为4就输出4空格 -
"json.format.keepLines"设为true可保留你手动换行的位置（适合大数组分项写），但默认是false，即全重排 - JSON标准不允许末尾逗号，VSCode格式化会主动删掉
{ "a": 1, }里的逗号——这不是bug，是合规行为
格式化失败的典型原因和绕过方法
报错信息通常是 Unable to format file 或控制台里出现 JSON language server: Parse error。根本原因几乎全是语法非法，而非VSCode问题。
- 最常见：用了单引号
'key': 'value'—— JSON只认双引号 - 注释（
//或/* */）会导致解析失败；想保留注释就得用JSONC模式，但此时默认格式化器不工作 - 字符串里含未转义的换行或控制字符（如
\u0000）也会中断解析 - 真需要处理带注释/非标JSON？临时改后缀为
.jsonc，再装一个支持它的格式化器（如Prettier），但记得切回.json再提交
复杂点在于：格式化动作本身不报具体哪一行错，只告诉你“解析失败”。这时候得靠 Ctrl+Shift+P → Developer: Toggle Developer Tools 看Console里的详细错误位置——很多人忽略这一步，就卡在“明明看着没问题”的假象里。
