Sublime Text需组合安装JSON Tools、SublimeLinter-json和BracketHighlighter插件才能实现JSON格式化、校验与高亮;安装后须设语法为JSON、用Ctrl+Alt+J格式化,并依赖SublimeLinter-json实时报错以确保JSON合法。

Sublime Text 本身不自带 JSON 格式化和语法校验功能,但通过安装 JSON Tools 或原生支持更强的 BracketHighlighter + SublimeLinter-json 组合,就能实现高亮、验证、折叠、格式化等完整 JSON 操作。关键不是“装一个插件”,而是选对组合并正确配置。
如何用 Package Control 安装 JSON 相关插件
Sublime Text 3/4 必须先确保已安装 Package Control(若未安装,官网下载 install_package_control.py 后通过 Ctrl+` 粘贴运行)。之后所有插件都走统一通道:
- 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS)呼出命令面板 - 输入
Package Control: Install Package回车 - 等待列表加载后,依次安装以下三个插件(推荐组合):
JSON Tools、SublimeLinter-json、BracketHighlighter - 安装完成后重启 Sublime(部分插件需重启才生效)
JSON Tools 的核心用法:格式化与 Pretty Print
JSON Tools 是最直接满足“格式化查看 JSON”的插件,但它默认不绑定快捷键,且对非法 JSON 会静默失败——这是新手最常见的卡点。
- 确保文件语法识别为
JSON:右下角点击语言名 → 选JSON(不是JavaScript或Plain Text) - 全量格式化:选中全部内容(
Ctrl+A),再按Ctrl+Alt+J(Windows)或Cmd+Alt+J(macOS) - 仅格式化选中块:不全选,直接用同一快捷键,它会对当前选区做缩进重排
- 如果没反应,大概率是 JSON 有语法错误(如末尾多逗号、单引号、注释)——此时应先用
SublimeLinter-json查错
为什么需要 SublimeLinter-json 而不只是 JSON Tools
JSON Tools 不校验,只美化;而 SublimeLinter-json 基于系统 json.tool 或 jq,实时标红错误位置,比如:
-
Expecting property name enclosed in double quotes(用了单引号或没引号) -
Invalid control character at(含不可见控制符,常见于复制粘贴的 API 响应) -
Expecting value(空文件、只有注释、BOM 头干扰)
它依赖 Python 环境:确保终端能运行 python -m json.tool --help;若报错,可在插件设置里指定 json_command 路径,例如:
"json_command": "/usr/bin/python3 -m json.tool"
格式化后仍显示混乱?检查编码与 BOM
即使 JSON 合法、插件正常,打开某些 API 返回的 JSON 文件仍显示乱码或格式错乱,根源常是:
- 文件带 UTF-8 BOM:Sublime 默认不忽略,会导致首行解析失败 → 用
File → Reopen with Encoding → UTF-8 - 响应含 \uXXXX Unicode 转义但未被解码:这不是插件问题,是数据源本身未 decode,
JSON Tools不做字符串内容转义处理 - 大文件(>5MB)卡顿:默认关闭折叠和高亮可缓解,在
Preferences → Settings加:"fold_buttons": false, "draw_white_space": "none"
真正影响体验的,往往不是“能不能格式化”,而是“有没有在格式化前发现根本不能解析”。校验和美化必须成对使用,缺一不可。










