pretty json 插件需满足三个前提：package control 正常、插件名准确拼写为“pretty json”（带空格）、文件语法模式设为 json；它仅格式化合法 json，不修复语法错误，中文乱码、缩进异常等问题需手动配置解决。
Pretty JSON 插件在 Sublime Text 中不是“装上就用”，它依赖三个前提同时成立：Package Control 正常、插件名拼写准确、文件语法模式为 JSON。2026 年 7 月，Pretty JSON（带空格）仍可通过 Package Control 安装，但 PrettyJSON（无空格）或 JSONPretty 是不同插件，行为不兼容。
Package Control 没装好，Pretty JSON 根本不会出现
按 Ctrl+Shift+P（macOS 为 Cmd+Shift+P）后命令面板空白、输入 Install Package 无响应，说明 Package Control 未生效。
- 打开控制台：
Ctrl+`，粘贴 ST4 官方安装脚本（含哈希校验），回车执行 - 若报错
Error validating download，可能是网络拦截或杀毒软件阻断，可手动下载Package Control.sublime-package放入Installed Packages/目录 - 重启 Sublime Text 后再试 —— 不重启，命令面板不会加载新插件
安装时搜 Pretty JSON，不是 PrettyJSON
Package Control 中的插件名是带空格的 Pretty JSON，大小写敏感，且与 JSON Reindent、JsFormat 完全无关。
- 调出命令面板 → 输入
Package Control: Install Package→ 等待列表加载完成（可能需几秒） - 在弹出搜索框中输入
Pretty JSON（注意空格和首字母大写），回车安装 - 安装后无需重启，但首次使用建议等 2–3 秒，避免命令未注册就触发快捷键
- 验证方式：
Ctrl+Shift+P输入Pretty JSON，能看到Pretty JSON: Format JSON即成功
格式化失败？大概率不是插件问题，而是 JSON 不合法
Pretty JSON 不修复语法，只格式化已合法的 JSON。静默失败（内容不变、无提示）是最常见现象。
- 检查是否用了单引号：
{'name': 'Alice'}❌ → 必须双引号：{"name": "Alice"}✅ - 删掉尾随逗号：
{"a": 1,}❌ →{"a": 1}✅ - 移除所有注释（
//或/* */），JSON 标准不支持 - 确认文件语法模式：右下角状态栏点击语言名（如
Plain Text），选JSON或JSON with Comments（后者仅限插件支持的宽松模式） - 选区影响范围：没选中文本 → 格式化整文件；只选一段 → 只处理该段
中文变 \u4f60\u597d、缩进混乱、快捷键无效
这些都不是插件 bug，而是配置没对齐。
- 中文乱码：打开
Preferences → Package Settings → Pretty JSON → Settings – User，添加"ensure_ascii": false - 缩进异常：先统一文件缩进（
View → Indentation → Convert Indentation to Spaces，设宽度为 2），再在插件设置中加"detect_indentation": false - 快捷键冲突：默认
Ctrl+Alt+J在 Windows 上易被输入法劫持；可在Preferences → Key Bindings用户文件中自定义，例如：[{"keys": ["ctrl+shift+h"], "command": "pretty_json", "args": {"operation": "prettify"}}]
真正卡住的地方，往往不是“怎么装”，而是“装完之后文件没设成 JSON 语法”或“以为插件能救活带注释的伪 JSON”。它只做一件事：把合法 JSON 排版得更易读。其他都得你来兜底。
