Sublime Text 需通过 Package Control 安装 PrettyJSON 插件实现 JSON 格式化,支持美化、校验与折叠,要求 UTF-8 编码、无注释/单引号等非标准语法,并注意选区范围影响操作结果。

Sublime Text 本身不自带 JSON 格式化功能,但通过安装 PrettyJSON 插件可以一键美化、校验、折叠/展开 JSON 数据。它比手动缩进或在线工具更安全(不上传数据),也比内置的 Ctrl+Shift+P → Pretty JSON 命令更稳定(后者常因 Python 环境缺失报错)。
确认 Sublime Text 版本和 Package Control 是否就绪
PrettyJSON 仅支持 Sublime Text 3 和 4,且必须通过 Package Control 安装。如果你执行 Ctrl+Shift+P 后没有出现命令面板,或输入 Install Package 无响应,说明 Package Control 未安装。
- 打开 Sublime Text,按
Ctrl+`(反引号)调出控制台,粘贴并回车运行官方安装脚本(以 ST4 为例):import urllib.request,os,hashlib; h = '6f4c264a24d933ce70df5dedc1efb800' + '1a3232031432121d212fd82e000121'; pf = 'Package Control.sublime-package'; ipp = sublime.installed_packages_path(); urllib.request.install_opener(urllib.request.build_opener(urllib.request.ProxyHandler())); by = urllib.request.urlopen('https://packagecontrol.io/' + pf.replace(' ', '%20')).read(); dh = hashlib.sha256(by).hexdigest(); print('Error validating download (got %s instead of %s), please try manual install' % (dh, h)) if dh != h else open(os.path.join(ipp, pf), 'wb').write(by) - 重启 Sublime Text,再按
Ctrl+Shift+P,输入Package Control: Install Package并回车,等待加载完成。
安装 PrettyJSON 插件并验证是否生效
插件安装后不会自动绑定快捷键,需手动触发或配置。常见失败原因是插件安装后未重启 Sublime,或 JSON 内容不含有效根对象(比如开头是数组 [{...}] 而非 {"key":...})。
- 按
Ctrl+Shift+P,输入Package Control: Install Package→ 回车 → 输入PrettyJSON→ 选择并回车安装。 - 安装完成后,打开一个
.json文件或纯文本视图(Ctrl+Shift+P → Set Syntax: JSON),选中全部内容(Ctrl+A)。 - 再次按
Ctrl+Shift+P,输入Pretty JSON,选择Pretty JSON: Format。若成功,会自动缩进并高亮语法;若报错Invalid JSON,说明原始内容有隐藏字符、BOM 或语法错误(如末尾多逗号、单引号代替双引号)。
处理非标准 JSON(带注释、单引号、变量)时怎么办
PrettyJSON 严格遵循 RFC 8259,不接受注释(// 或 /* */)、单引号字符串、未转义的换行符。这类内容常见于配置文件(如 webpack.config.js)或前端 mock 数据。
- 先用正则替换清理:按
Ctrl+H打开替换面板,勾选.*(正则模式),查找//.*$替换为空,再查找'([^']*)'替换为"$1"(注意:仅适用于简单字符串,嵌套引号会失效)。 - 更稳妥的方式是把内容复制到浏览器控制台,执行
JSON.stringify(JSON.parse(editorContent), null, 2)(前提是 JS 环境可运行),再粘贴回 Sublime。 - 如果只是临时查看,可用
Ctrl+Shift+P → Pretty JSON: Validate快速定位错误位置(光标跳转到首个非法字符处)。
格式化后中文乱码或缩进异常
乱码通常源于文件编码不是 UTF-8 无 BOM;缩进异常多因 JSON 中混入制表符(\t)或全角空格。Sublime 默认用空格缩进,但 PrettyJSON 的缩进宽度由设置决定。
- 检查编码:菜单栏
File → Reopen with Encoding → UTF-8,再执行格式化。 - 统一缩进:打开
PrettyJSON设置(Preferences → Package Settings → Pretty JSON → Settings),确保"indent": 2(数字,不是字符串),且"ensure_ascii": false(保留中文而非转义)。 - 清除不可见字符:按
Ctrl+Shift+P → View: Toggle Whitespaces查看空格/制表符,手动删掉异常符号,或用正则\s+$替换掉行尾空白。
真正容易被忽略的是:格式化操作只作用于当前选区。如果没选中任何内容,Pretty JSON: Format 会尝试格式化整个文件;但如果光标在某一行中间且未全选,它可能只处理从光标到行尾的部分——结果看似“没反应”,其实是格式化了半截内容。










