必须先安装并验证package control可用,再通过其安装pretty json插件;插件支持.json/.jsonc格式,需手动设置快捷键(如ctrl+alt+j)和用户配置(如indent、sort_keys、ensure_ascii)才能正常格式化。

安装 Pretty JSON 插件前先确认 Package Control 已就绪
如果 Package Control 没装好,后续所有插件都装不上。别跳过这步——很多人卡在这儿,以为是插件问题,其实是包管理器没激活。
验证方式:按 Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(macOS),弹出命令面板;输入 Package Control: Install Package,能搜到并执行,说明已就绪。搜不到?得重装 Package Control——去官网复制 Python 安装脚本,粘贴进 View → Show Console 运行,注意 Sublime Text 4 要用对应版本脚本(旧脚本在 ST4 下会静默失败)。
通过 Package Control 安装 Pretty JSON 插件
装完 Package Control 后,才是正经装 Pretty JSON 的时候。它不是官方插件,但长期维护、支持 JSON5 和带注释的 JSON(比如 .jsonc),比原生格式化更实用。
- 按
Ctrl+Shift+P打开命令面板 - 输入
Package Control: Install Package回车 - 等待几秒,再输入
Pretty JSON(注意大小写和空格,别输成PrettyJson或pretty-json) - 选中后回车,状态栏会显示 “Installing…”,完成后无提示,但可重启 Sublime 或新建
.json文件测试
常见失败原因:Package Control 网络超时(尤其国内)、插件名拼错、Sublime 版本太老(ST3 仍可,但 ST2 不支持)。
用快捷键或右键菜单格式化 JSON
装完不等于能用——默认没绑定快捷键,得手动触发或设热键。否则打开一个杂乱 JSON,光标放里面按 Ctrl+Alt+J 没反应,容易误以为没生效。
- 手动触发:右键 →
JSON → Pretty Print(菜单项名称严格如此,不是 “Format” 或 “Beautify”) - 推荐设快捷键:打开
Preferences → Key Bindings,在右侧用户文件里加一行:[{"keys": ["ctrl+alt+j"], "command": "pretty_json"}] - 支持格式:标准
.json、.jsonc(VS Code 风格注释)、部分.sublime-settings文件(但不建议对核心配置文件直接格式化,可能破坏注释结构)
注意:如果 JSON 语法错误(比如多逗号、引号不闭合),Pretty JSON 会报错 Invalid JSON 并中断,不会强行美化——这是保护机制,不是 bug。
格式化结果不符合预期?检查 indent 和 sort 设置
Pretty JSON 默认用 2 空格缩进、不排序 key,但项目规范常要求 4 空格或字母序。这些得改配置,不是靠“重新安装”解决。
- 打开
Preferences → Package Settings → Pretty JSON → Settings - 在右侧用户设置中添加:
{ "indent": 4, "sort_keys": true, "ensure_ascii": false } -
ensure_ascii设为false才能保留中文等非 ASCII 字符原样显示,否则全转成\uXXXX - 改完保存,无需重启,下次格式化立即生效
容易忽略的一点:某些团队用 jq 或 prettier 做统一格式化,Sublime 里美化后提交前又被 CI 拦住重排——建议先确认项目 .prettierrc 是否存在,避免本地和流水线格式打架。










