Pretty JSON插件需通过Package Control安装,依赖Sublime内置Python;默认快捷键Ctrl+Alt+J格式化全文,仅支持合法JSON语法校验,不支持注释、局部格式化及Schema语义检查。

Sublime Text 本身不内置 JSON 格式化与校验功能,必须通过插件实现;Pretty JSON 是最常用、轻量且稳定的方案,但安装和使用中存在几个关键断点——比如 Python 环境依赖、快捷键冲突、以及对非法 JSON 的静默失败。
如何正确安装 Pretty JSON 插件
它依赖 Sublime 自带的 Python 环境(Sublime Text 3/4 内置 Python 3.3+),不需额外装 Python,但必须通过 Package Control 安装,手动复制文件或拖入插件目录会失效:
- 确保已安装
Package Control(没装就先按Ctrl+`调出控制台,粘贴官方安装脚本) - 按下
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS),输入Install Package回车 - 搜索
Pretty JSON,点击安装(注意名称是Pretty JSON,不是JSON Reindent或JSONLint) - 安装完成后重启 Sublime(部分版本需重启才加载 Python 模块)
格式化 JSON 的实际操作与常见失败原因
默认快捷键是 Ctrl+Alt+J(Windows/Linux)或 Cmd+Ctrl+J(macOS),但常被系统或其他插件占用;触发后若无反应,大概率是以下之一:
- 当前文件未被识别为 JSON:确保文件后缀是
.json,或右下角状态栏显示JSON(可点击切换语法) - 内容含非法字符:如末尾多逗号、单引号代替双引号、注释(
//或/* */)——Pretty JSON不支持注释,会直接报错Expecting property name enclosed in double quotes - 选中了部分内容:该插件只格式化全文,不支持局部格式化;若只想处理某段,需先复制到新标签页再操作
校验 JSON 是否合法的两种方式
Pretty JSON 的校验是隐式的:格式化成功 = 合法;失败 = 非法。没有独立“校验”命令,但可通过以下方式确认:
- 执行
Ctrl+Alt+J后弹出错误提示框(如Invalid JSON: Expecting value),说明语法错误 - 执行后内容不变且无提示,可能是 JSON 合法但已格式化,也可能是插件未生效(检查语法类型和文件编码是否为 UTF-8)
- 想主动触发校验,可临时删掉一个
}再格式化,看是否报错——这是最直接的验证手段
真正容易被忽略的是:它不检查 JSON Schema,也不报告字段缺失或类型错误,只做基础语法解析;如果需要语义校验(比如 API 返回字段是否符合约定),得配合外部工具或改用 VS Code + redhat.vscode-yaml 类扩展。










