pretty json 是 sublime text 最成熟的 json 格式化插件,但需先正确安装 package control,确保语法模式为 json、内容合法且选区明确,否则会静默失败。

Sublime Text 本身不带 JSON 格式化功能,所谓“一键排版”必须依赖插件;Pretty JSON 是目前最成熟、容错性最好、命令最稳定的方案,但它的“一键”不是点一下就完事——它对环境、语法、选区、语言模式都有明确要求,任一条件不满足就会静默失败。
Package Control 没装好,Pretty JSON 根本装不上
所有插件安装都卡在第一步:Ctrl+Shift+P(macOS 是 Cmd+Shift+P)打开命令面板后,输入 Install Package 没反应,或列表为空。这不是网络慢,而是 Package Control 根本没注册成功。
- 先按
Ctrl+`打开控制台,粘贴官网最新安装脚本(ST4 要求校验哈希,别用旧版)并回车执行 - 执行后无报错 ≠ 安装成功:重启 Sublime Text,再按
Ctrl+Shift+P输入Package Control:,能看到下拉项才算真正就位 - 如果仍失败,检查杀毒软件是否拦截了 Sublime 的网络请求;或手动下载
Package Control.sublime-package,放进Installed Packages/目录(路径可通过Preferences → Browse Packages…进入)
Pretty JSON 安装后命令不可见或快捷键无效
安装完成后,在命令面板搜 Pretty JSON: Format JSON 看不见,或按默认快捷键 Ctrl+Alt+J(Windows/Linux)/Cmd+Alt+J(macOS)没反应,大概率是名称输错或冲突了。
- 别搜
JSON format或beautify—— 插件全名就是Pretty JSON,注意空格和首字母大写 - 安装后不用重启,但首次调用建议等 3–5 秒,避免命令注册延迟
- 快捷键被占用时不会报错,只“失灵”:比如 Windows 上某些输入法会劫持
Ctrl+Alt+J,可进Preferences → Key Bindings自定义绑定,例如改成["ctrl+shift+j"]
按下格式化命令后内容完全没变
这是最常被误判为“插件坏了”的情况。实际上 Pretty JSON 不修复语法错误,只格式化合法 JSON。只要内容含单引号、尾随逗号、JS 风格注释、未闭合括号,它就直接放弃处理,不提示、不报错、不动光标。
- 验证合法性:把内容复制进浏览器 DevTools 的 Console,执行
JSON.parse(你的文本);或终端运行python -m json.tool yourfile.json - 文件右下角状态栏必须显示
JSON:点击当前语言名(如Plain text),手动选成JSON,否则命令可能灰显或行为异常 - 没选中文本时格式化整个文件;若只选了一段,就只处理那段——大型日志文件里混着非 JSON 内容时,务必先手动框选目标片段
真正容易被忽略的点是:格式化不是万能胶水。它不负责纠错,也不自动切换语法模式,更不会帮你删掉调试用的 // 注释。你给它什么,它就格式化什么——前提是,那真是 JSON。











