Python不能直接运行JSON文件，因其非可执行格式，会报语法错误；正确做法是用json.tool校验合法性，或用专用插件格式化。
为什么不能直接用 python 运行 JSON 文件
JSON 不是可执行格式，python 命令本身无法直接“运行”一个 .json 文件——它会报 IndentationError 或 SyntaxError。所谓“JSON 构建系统”，真实目标只有两个：校验语法合法性，或配合工具做格式化/转换。强行写 "cmd": ["python", "$file"] 一定会失败。
json.tool 是最轻量的语法校验方案
Python 自带的 json.tool 模块能快速验证 JSON 是否合法，并在出错时输出具体位置。这是 Sublime 中最稳妥、无需额外依赖的校验方式。
-
"cmd": ["python", "-m", "json.tool", "$file"]—— 注意必须用-m调用模块，不能直接传文件给python -
"file_regex"对校验无效，不用配；错误信息格式固定，Sublime 无法跳转到行号，但至少能看清哪一行崩了 - 如果 JSON 含中文或 BOM，建议加
"env": {"PYTHONIOENCODING": "utf-8"}，否则可能报UnicodeDecodeError - Windows 下若提示
'python' is not recognized，需确认系统 PATH 已包含 Python，或改用绝对路径如"C:\Python311\python.exe"
想格式化？别碰构建系统，用插件
构建系统本质是“执行命令 + 捕获输出”，不适合做格式化：它不修改原文件、不支持缩进配置、无法保留注释（JSON 标准不支持）、也不能触发保存后自动美化。这些是编辑器层面的功能，不是构建动作该干的事。
- 装
HTML-CSS-JS Prettify插件，而非试图写jq或python -m json.tool --indent 2到cmd里 - 格式化快捷键（如
ctrl+alt+j）必须绑定在source.json语法下，否则按了没反应 - 确保文件编码是
UTF-8，不是UTF-8 with BOM——后者会让js-beautify静默失败，控制台也不报错 - 如果
Ctrl+Shift+P → JSON Reindent找不到命令，先检查 Package Control 是否装好并重启过编辑器
真要跑外部工具（比如 jq），得绕过 Windows 的 && 陷阱
有人想用 jq 校验+格式化一体完成，例如：jq empty $file && jq '.' $file。但在 Windows 的默认 cmd 下，&& 不被 exec 命令正确解析，会导致第二条命令完全不执行。
- 解决方案一：强制走 shell，改用
"shell_cmd": "jq empty "$file" && jq '.' "$file""（注意双引号转义） - 解决方案二：写个批处理或 PowerShell 脚本封装逻辑，再让
cmd调用它，比硬塞 shell 语法更可控 - macOS/Linux 用户可直接用
shell_cmd，但记得$file要加引号，防止路径含空格时报错 - 无论哪种方式，
jq必须已安装且在 PATH 中，否则构建面板只显示'jq' is not recognized
