vscode格式化json需满足两个前提:语言模式必须设为json(非json with comments或plain text),且原始内容语法合法;否则shift+alt+f静默失败。

VSCode格式化凌乱JSON数据,核心就两点:语言模式必须是JSON,原始内容必须是合法JSON。跳过任一条件,Shift+Alt+F(Windows/Linux)或Shift+Option+F(macOS)都会静默失败或报Unexpected token错误。
确认语言模式是JSON,不是Plain Text或JSON with Comments
VSCode不会自动把无后缀、.txt、.config 或从浏览器复制的文本识别为JSON——它只看右下角状态栏。一旦显示Plain Text,所有格式化和校验功能全部失效。
- 点击右下角语言标识(如“Plain Text”),输入
json回车,选中JSON(注意不是JSON with Comments) - 快捷键更快:
Ctrl+K M(Win/Linux)或Cmd+K M(macOS),然后输json - 如果文件后缀不是
.json(比如叫data或config),改后缀最稳;临时处理可不改,但必须手动切语言模式
先验证再格式化:JSON语法不合法,Shift+Alt+F不干任何事
格式化器不是修复器。它只美化结构,不补逗号、不转单引号、不删注释、不清理零宽字符。这些都得你手动或借助工具预处理。
- 检查开头是否为
{或[,结尾是否对应闭合 - 把中文引号
“key”、单引号'name': 'alice'全换成英文双引号:"name": "alice" - 删掉所有
//或/* */注释——纯JSON模式不支持 - 从微信、PDF、邮件复制的内容常含零宽字符,可用正则
/[\u200b-\u200f\u202a-\u202f\u2060-\u206f\ufeff]/g全局替换为空 - 临时验证语法:按
Ctrl+Shift+P→ 输入JSON: Validate,它会立刻标出哪一行出错
用vscode.json-language-features作为默认格式化器
VS Code 1.85+ 默认禁用了旧格式化逻辑,改用更严格的内置服务。如果你装了Prettier等插件,它很可能劫持了.json文件的格式化权,导致缩进错乱、引号被改、甚至格式化按钮灰显。
- 打开设置(
Ctrl+,),搜defaultFormatter→ 找到Editor: Default Formatter - 展开
JSON语言项,确保值是vscode.json-language-features(不是esbenp.prettier-vscode) - 若已用Prettier,且必须让它管JSON,请在
settings.json里显式声明:"[json]": {"editor.defaultFormatter": "esbenp.prettier-vscode"},并确认.prettierrc含"parser": "json" - 检查
json.format.enable是否为true(默认开启,但有人手抖关过)
格式化后字段顺序变了?这不是bug,是设计
VSCode内置格式化器不保证键名顺序——因为JSON对象本身无序。它只做缩进、换行、括号对齐。如果你需要按字母排序键名,得额外操作:
- 全选JSON内容 → 按
Ctrl+Shift+P→ 输入Sort JSON Object Keys回车 - 注意:排序会破坏语义顺序(比如
dependencies必须在devDependencies前),别在package.json等有约定顺序的配置里无脑启用 - 想保留大数组的手动换行(避免格式化后挤成一行),设
json.format.keepLines为true
最容易被忽略的其实是语言模式切换动作——很多人卡在第一步,反复重装插件、改配置,却没点一下右下角那个小小的文字标签。











