Sublime Text 需通过 Package Control 安装 Pretty JSON 插件实现 JSON 格式化，安装前须确保 Package Control 已正确安装并可用，插件仅格式化合法 JSON，且要求文件语法模式为 JSON、无快捷键冲突。
Sublime Text 本身不带 JSON 格式化功能，所谓“一键排版”必须依赖插件；Pretty JSON 是目前最成熟、功能最全的选择，但安装和使用有明确前提——它不工作，大概率不是插件问题，而是环境或操作细节没对上。
确认 Package Control 已安装且可用
Pretty JSON 必须通过 Package Control 安装，而后者不是 Sublime 自带组件。如果按 Ctrl+Shift+P（macOS 为 Cmd+Shift+P）后命令面板空白、无响应，或输入 Install Package 没反应，说明 Package Control 根本没装好。
- 打开控制台：
Ctrl+`（反引号），粘贴官网脚本并回车执行（注意：ST4 脚本含校验哈希，ST3 可用简化版） - 执行后若无报错，重启 Sublime Text 再试
Ctrl+Shift+P - 仍失败？检查是否被杀毒软件拦截了网络请求，或手动下载
Package Control.sublime-package放入Installed Packages/目录
安装 Pretty JSON 插件的正确路径
别搜 “JSON format” 或 “beautify”，直接搜插件全名：Pretty JSON。它和 JSONPretty、JSON Reindent 是三个独立插件，命令、行为、容错性完全不同。
- 按
Ctrl+Shift+P→ 输入Package Control: Install Package→ 回车等待列表加载完成 - 在弹出的搜索框中输入
Pretty JSON（注意空格和大小写，首字母大写）→ 回车安装 - 安装完成后无需重启，但首次使用建议等几秒，避免命令未注册就急着调用
- 验证是否生效：再次
Ctrl+Shift+P，输入Pretty JSON: Format JSON，能看见即成功
格式化失败的常见原因与对应操作
按下快捷键或执行命令后内容毫无变化，不是插件坏了，而是触发条件不满足。最常踩的坑是误以为“格式化 = 修复语法错误”。
-
Pretty JSON不校验也不修正语法：单引号、尾随逗号、注释、未闭合括号都会导致静默失败——光标不动、无提示、内容原样 - 先验证合法性：复制内容到浏览器 Console 执行
JSON.parse()，或终端运行python -m json.tool yourfile.json - 选区影响结果：没选中任何文本时，它会格式化整个文件；若只选了一段，就只处理那段——大型文件建议先手动选中目标 JSON 片段
- 文件语法模式必须是
JSON：右下角状态栏点击当前语言名（如Plain text），选JSON；否则命令可能不可用或行为异常
快捷键冲突与自定义绑定
默认快捷键 Ctrl+Alt+J（Windows/Linux）或 Cmd+Alt+J（macOS）容易被输入法、终端模拟器或其他插件占用，失效时不报错，只“没反应”。
- 打开
Preferences → Key Bindings，右侧用户文件中添加新绑定，例如： [ {"keys": ["ctrl+alt+j"], "command": "pretty_json"} ]- 注意：
command值必须是pretty_json，不是json_pretty_print（那是JSONPretty的命令）或json_reindent（另一个插件） - 保存后立即生效，不用重启；可设多个快捷键，比如同时保留
Ctrl+Alt+J和Ctrl+Shift+H
真正麻烦的从来不是装不上插件，而是格式化失败时你不知道该去查哪一层——是网络没连上、Package Control 没加载、插件命令名拼错了、JSON 本身非法，还是当前语法模式不对。每一步都有明确的验证方式，漏掉任意一环，都会卡在“为什么按了没反应”。
