Sublime Text 本身不支持自动排版，所有“保存即格式化”“一键重排”均依赖插件，且必须满足Package Control正确加载、CLI工具（如prettier/black）终端可执行、右下角语法模式正确三个硬性条件。
Sublime Text 本身不支持自动排版，所有“保存即格式化”“一键重排”都依赖插件，且必须满足三个硬性条件：Package Control 已正确加载、对应 CLI 工具（如 prettier 或 black）在终端可执行、右下角语法模式显示正确（比如不是 Plain Text）。缺一不可。
Package Control 装不上？先确认控制台能跑通安装脚本
菜单里找不到 Package Control 不是网络慢，是根本没装成。必须用 Ctrl + ` 打开底部 Python 控制台，粘贴官方 HTTPS 安装脚本（https://packagecontrol.io），回车执行。看到 Package Control installed 才算成功。
执行完不重启 = 白装：彻底退出 subl.exe（Windows）或终止 Activity Monitor 中所有 Sublime 进程（macOS），再重开。之后按 Ctrl + Shift + P 输入 Package Control:，能拉出下拉列表才算真正就位。
- 控制台报
URLError或长时间无响应？检查杀毒软件是否拦截了 HTTPS 请求 - 仍失败？手动下载
Package Control.sublime-package，放进Installed Packages/目录（路径可通过Preferences → Browse Packages…进入） - 别信旧教程里的
http://sublime.wbond.net链接——2026 年起已全部失效
JS/TS/JSON 用 JsPrettier，别碰 HTML-CSS-JS Prettify
JsPrettier 是当前最稳的前端格式化方案，它调用本地 prettier CLI，支持 ES2024、JSX 和最新模板字符串；而名字相似的 HTML-CSS-JS Prettify 多年未更新，对 const x = { a: 1, } 这类尾随逗号都会误判。
装完后必须立刻验证：按 Ctrl + Shift + P 输入 JsPrettier 回车，首次运行会生成 JsPrettier.sublime-settings。关键配置要手动加：
-
"prettier_options": { "config_precedence": "file-override" }—— 否则它无视项目级.prettierrc -
"prettier_cli_path"必须填绝对路径，Windows 用户要带.cmd后缀，例如C:\Users\xxx\AppData\Roaming\npm\prettier.cmd - 终端执行
prettier --version无输出？说明 Node.js 没装或PATH没生效，Sublime 重启后也识别不到
Python 必须用 sublime_black + black，AutoPEP8 已淘汰
AutoPEP8 只修空格和换行，对 match 语句、f-string 内部换行、类型注解完全无感；sublime_black（作者 zabb0t）才真正对标团队 CI 中的 black 行为。
安装顺序不能错：
- 先在终端运行
pip install black（推荐进项目venv，避免全局污染） - 再通过 Package Control 安装
sublime_black（注意不是同名旧插件） - 打开插件设置，确认
"use_stdin": true已启用——这是 Sublime 把选中代码传给black的开关 - 默认快捷键
Ctrl + Shift + K在中文输入法下常冲突，建议在Preferences → Key Bindings改成Ctrl + Alt + L
格式化没反应？先看右下角是不是 Plain Text
Sublime 不会自动猜语言，右下角显示 Plain Text 时，所有格式化命令都静默失效（灰显或无响应）。必须手动点击右下角语言名，选成 JavaScript、Python、JSON 或 HTML；或者直接把文件保存为 .js、.py、.json、.html 后缀，让编辑器自动切换。
常见静默失败场景：
- JSON 文件含单引号或
//注释？Pretty JSON插件直接跳过，不报错也不提示 - HTML 里写
<script>const html = `<div>${x}`</script>？HTML-CSS-JS Prettify会把反引号当标签解析，建议拆成单独.js文件再处理 - XML 有未闭合标签或裸露
&？XML Tools会报xml.parsers.expat.ExpatError，得先用python -m xml.etree.ElementTree校验
真正卡住人的地方，从来不是“怎么装”，而是装完发现没反应，然后反复重装插件——其实问题早就在控制台里：prettier failed: command not found 或 black failed: error: cannot format stdin，只是你没去看。
