jsonreindent装不上需先确认package control已安装并重启,再确保文件语法模式为json、内容合法且编码为utf-8无bom,否则命令不触发或静默失败。

JSONReindent 装不上?先确认 Package Control 和语法模式
装完没反应,八成是前提没立住。Sublime Text 本身不带 JSON 格式化能力,JSONReindent 是纯 Python 插件,依赖 Package Control 才能安装和注册命令。按 Ctrl+Shift+P(macOS 是 Cmd+Shift+P)输入 Install Package Control,如果没这个选项,就得去官网复制 Python 脚本,粘进 View → Show Console 执行——这步跳过,后面所有插件都白装。
装完重启 Sublime,再按 Ctrl+Shift+P 输入 Package Control: Install Package,等列表加载完,搜 JSON Reindent(注意拼写,不是 JsonReindent 或 JSONReindent),回车安装。装完务必重启一次,尤其 Sublime Text 3 用户。
打开一个 .json 文件,看右下角状态栏是否显示 JSON;如果显示 Plain text,右键 → Set Syntax → JSON 手动切过去——JSONReindent 只响应 source.json 语法上下文,其他模式下命令根本不会触发。
快捷键 Ctrl+Alt+J 不生效?检查三个硬性条件
JSONReindent 默认绑定 Ctrl+Alt+J(Windows/Linux)或 Cmd+Ctrl+J(macOS),但这个快捷键只在满足全部条件时才工作:
- 当前文件语法必须是
JSON(右下角显示) - 光标不能落在字符串内部,比如
"name": "hello|world"中的竖线位置——此时插件会直接报Invalid JSON: Expecting property name enclosed in double quotes - 没有被其他插件劫持:Emmet、SideBarEnhancements 等常用插件也用
Ctrl+Alt+J,可临时禁用它们测试;或打开Preferences → Key Bindings,在右侧用户文件里手动加一行:[{"keys": ["ctrl+alt+j"], "command": "json_reindent"}]
临时验证是否装对:新建标签页,粘一段合法 JSON(如 {"a":1,"b":[2,3]}),全选后按 Ctrl+Alt+J,立刻看到缩进变化——没反应就回头查语法模式或快捷键冲突。
格式化后变空白或报错?JSON 本身不合法
JSONReindent 只做缩进重排,不做语法校验。它遇到非法 JSON 会静默失败或弹出错误提示,但绝不会“美化出错的数据”。常见非法写法包括:
- 单引号代替双引号:
'key': 'value' - 末尾多余逗号:
{"a":1,} - 未闭合括号或引号:
{"a": [1, 2, {"b": 3} - 路径反斜杠没转义:
"path": "C: emp"应为"path": "C:\temp"
验证方法最直接:把内容复制进浏览器控制台执行 JSON.parse(…);或终端运行 python -m json.tool yourfile.json。只有通过验证的 JSON,JSONReindent 才会正常工作。
缩进空格数不对?别改全局设置,单独配插件
JSONReindent 默认用 4 空格缩进,但 JSON RFC 推荐 2 空格。它不读取 tab_size 全局设置,必须进插件专属配置:
打开 Preferences → Package Settings → JSON Reindent → Settings,在右侧用户设置里加:
{
"indent": 2
}
注意字段名是 indent(不是 indent_size 或 tab_size),值必须是整数。改完保存,重新格式化即可生效。另外,确保文件编码是 UTF-8(不含 BOM),BOM 会导致部分插件解析失败且不报错——用 File → Save with Encoding → UTF-8 强制覆盖。
大文件卡顿、中文乱码、键排序需求……这些都不是 JSONReindent 的职责。它只干一件事:缩进重排。要校验、压缩、排序或 Unicode 可读,得换别的工具,比如 html-css-js-prettify 或命令行 jq。











