安装官方扩展Sort JSON(作者mohsen1),重启VSCode后,选中合法JSON对象范围排序,启用preserveComments等设置可保留注释与格式,快捷键仅在JSON语言模式下生效。

VSCode 本身不支持 JSON 键排序,必须依赖扩展。安装 Sort JSON 是最直接、最低侵入的方案,尤其适合处理嵌套深、含数组、带注释的复杂 JSON。
怎么装 Sort JSON 扩展才不会踩坑
别搜“Sort JSON Keys”或“JSONTools”——它们功能重叠但行为不一致,容易混淆。认准官方名 Sort JSON(作者:mohsen1),VS Code Marketplace 上安装量最高、更新最勤(截至 2026 年 4 月仍活跃维护)。
- 按
Ctrl+Shift+X打开扩展面板,搜索Sort JSON - 确认作者是
mohsen1,点击 Install - 安装后**必须重启 VSCode**,否则命令面板里搜不到
Sort JSON相关命令 - 如果已装过其他 JSON 排序类插件(如
JSON Sort或JSONTools),建议先卸载,避免右键菜单冲突或快捷键覆盖
对复杂 JSON 排序时,选中范围决定结果是否可靠
复杂 JSON 常见于配置文件(如 package.json)、API 响应快照、或嵌套多层的对象数组。此时不能全选再排序——Sort JSON 默认只处理“合法 JSON 对象字面量”,遇到数组顶层或语法错误会静默失败。
- 想排单个对象?把光标放在
{和}之间,或用鼠标拖选整个{...}区域(含花括号) - 想排数组里的每个对象?逐个选中每个
{...},或用多光标(Ctrl+D重复选中)批量触发 - 想排整个文件?确保文件内容是纯 JSON 对象(不是以
[开头的数组),否则会报错Unexpected token [ in JSON at position 0 - 含注释的 JSON(即
jsonc)?先在右下角点击语言模式,手动切到JSON with Comments,再排序
保留注释和格式的隐藏开关
默认情况下,Sort JSON 会删掉所有行内注释和换行,变成紧凑格式。这不是 bug,是设计如此——但你可以关掉它。
- 打开设置(
Ctrl+,),搜索sortJSON.preserveComments,勾选启用 - 再搜索
sortJSON.keepArrayOrder,设为true可防止插件误把数组元素当对象重排 - 如果排序后缩进变乱,检查当前文件是否绑定了其他格式化工具(如 Prettier)。可在命令面板运行
Format Document With...,手动选Sort JSON而非默认格式化器
为什么快捷键 Shift+Alt+O 有时没反应
这个快捷键不是全局生效的,它只在当前语言模式为 JSON 或 JSON with Comments 时激活。如果你在 .js 文件里粘了一段 JSON 字符串,即使选中了,快捷键也无效。
- 临时解决:选中 JSON 片段 → 右键 →
Sort JSON Alphabetically - 长期解决:用
Ctrl+Shift+P打开命令面板,输入Sort JSON,从列表里选对应命令(推荐Sort JSON Alphabetically (recursive)处理嵌套) - 注意:递归排序会进入所有子对象,但不会动数组项顺序——这点常被忽略,导致你以为“没排全”
真正复杂的 JSON(比如含函数字符串、循环引用占位符、或混合了环境变量语法)别硬塞给 Sort JSON——它只做字典序重排,不解析语义。这种场景该交给脚本或专用 CLI 工具,而不是编辑器插件。


















