pretty json 插件安装或格式化失败,主因是package control未正常运行、语法未切换为json、或json内容非法;需确认package control安装成功、严格输入“pretty json”安装、右下角切至json语法、验证json合法性、设置ensure_ascii为false及禁用自动缩进检测。

Pretty JSON 插件装不上或格式化失败,基本不是插件本身的问题,而是 Package Control 没跑起来、语法没切对、或者 JSON 内容不合法。
Package Control 装好了吗?Ctrl+Shift+P 按下去得有反应
Sublime Text 不自带插件管理器,Pretty JSON 必须通过 Package Control 安装。如果按 Ctrl+Shift+P(macOS 是 Cmd+Shift+P)后命令面板空白、卡住、或输 Install Package 没反应,说明 Package Control 根本没装好。
- 打开控制台:
Ctrl+`(反引号),粘贴官网脚本回车执行(ST4 脚本含哈希校验,别用 ST3 的旧版) - 执行后无报错 ≠ 成功:重启 Sublime 再试
Ctrl+Shift+P,如果仍无响应,检查杀毒软件是否拦截了网络请求 - 手动补救:下载
Package Control.sublime-package文件,放进Installed Packages/目录下
安装 Pretty JSON 插件的唯一正确路径
别搜 “JSON format”“beautify” 或 “PrettyJSON”(没空格会找不到),也别和 JSON Reindent、JSONPretty 混淆——它们命令不同、行为不同、容错性也不同。
- 按
Ctrl+Shift+P→ 输入Package Control: Install Package→ 回车等待列表加载完成 - 在弹出的搜索框里,**严格输入
Pretty JSON(带空格,首字母大写)** → 回车安装 - 装完不用重启,但首次调用建议等 2–3 秒,避免命令未注册就急着按快捷键
- 验证是否生效:再按
Ctrl+Shift+P,输入Pretty JSON: Format JSON,能看见即成功
格式化失败?先看这三件事有没有做对
按下 Ctrl+Alt+J 后内容没变、也没提示,不是插件坏了,是触发条件没满足。Pretty JSON 不修复语法,只格式化合法 JSON。
-
右下角状态栏显示的是Plain text还是JSON?必须点它手动切到JSON,否则命令不可用或静默失效 - 复制内容到浏览器控制台执行
JSON.parse(你的字符串),或终端跑python -m json.tool yourfile.json,确认无Unexpected token类错误 - 选中了部分文本?它只处理选区;没选中则格式化全文。大型文件建议先手动选中目标片段,避免整文件重排错乱
中文显示 \u4f60\u597d?改 ensure_ascii 就行
这是默认行为,符合 JSON 标准但不友好。改设置两行就够了,不影响其他插件:
- 打开
Preferences → Package Settings → Pretty JSON → Settings - 在
User设置里加这两行(或修改已有项):{ "ensure_ascii": false, "indent": 2 } - 保存后,再格式化,中文字段值就正常显示了
缩进混乱?不是插件问题,是 Sublime 自身缩进设置和插件配置打架:先统一设为 Indent Using Spaces、宽度为 2,再在 Pretty JSON 设置里加 "detect_indentation": false,否则它会试图猜缩进,反而覆盖你设的 indent: 2。











