Package Control未真正就位是插件安装失败的主因——唯一验证方式是Ctrl+Shift+P输入“Package Control: Install Package”后左下角出现“Fetching list of available packages”,否则所有安装操作均无效。

Sublime Text 本身不提供自动排版能力,所谓“自动排版”全是靠扩展工具调用外部 CLI 实现的——没装对插件、没配好 CLI 路径、状态栏语法模式不对,按烂快捷键也不会动一格。
怎么确认 Package Control 已真正就位
所有插件安装都卡在这一步。按 Ctrl+Shift+P 输入 Package Control: Install Package 没反应?不是网络慢,是包管理器根本没注册成功。
- 按
Ctrl+`打开控制台,粘贴官网最新 ST4 兼容脚本(含哈希校验),回车执行 - 执行无报错 ≠ 成功:必须完全退出 Sublime Text 再重开,再按
Ctrl+Shift+P输入Package Control:,看到下拉项才算到位 - 杀毒软件可能拦截 HTTPS 请求,临时禁用试试;或手动下载
Package Control.sublime-package,放进Installed Packages/目录
不同语言该装哪个插件才不踩坑
别搜“格式化”“beautify”这种泛词,直接按语言选已验证稳定的插件,否则容易装错、静默失败。
- JavaScript / TypeScript / JSON:装
JsPrettier,但必须提前运行npm install -g prettier,并在插件设置里填prettier_cli_path绝对路径(Windows 要带.cmd后缀) - Python:装
sublime_black(不是AutoPEP8),终端先跑pip install black,确保black --version可执行 - JSON:装
Pretty JSON,只处理合法 JSON——//注释、单引号、尾随逗号都会导致静默跳过,不报错也不提示 - SQL:装
SQLBeautifier,纯本地运行,无需数据库连接,支持"keyword_case": "upper"等自定义 - HTML/CSS/JS 混合文件:用
HTML-CSS-JS Prettify,轻量、无需 CLI,但 Vue 单文件组件慎用,会错乱嵌套块
为什么按快捷键没反应、内容不变、也没报错
这不是插件坏了,是触发条件断了。Sublime 的格式化插件几乎全靠“管道”工作,任一环节不通就静默拒绝。
- 右下角状态栏显示
Plain Text?点它手动选成JavaScript、JSON或对应语言;后缀名(如.js)只是辅助,不保证自动识别 - 命令面板搜不到
js_prettier或pretty_json?说明插件没加载成功,重启 Sublime 或执行Package Control: Satisfy Dependencies - 格式化后内容原样?先验证代码合法性:JSON 用
python -m json.tool yourfile.json,JS 用浏览器 Console 执行JSON.parse()或eval()(仅测试环境) - 没选中文本时格式化整文件;若只选了一段,就只处理那段——日志里混着非 JSON 内容时,务必先手动框选目标片段
快捷键怎么配才可靠不冲突
别抄网上过时的 "command": "format_code",这个命令名在原生 Sublime 和主流插件里都不存在。必须用插件实际注册的命令名。
- 按
Ctrl+Shift+P输入插件关键词(如js prettier),看到的完整命令名才是你要的,比如js_prettier或black - 编辑
Preferences → Key Bindings,只改右侧User.sublime-keymap文件,内容必须是合法 JSON 数组,例如:[{"keys": ["ctrl+alt+j"], "command": "pretty_json"}] - 多个插件共存时冲突高发,建议按语言区分:
ctrl+alt+h给 HTML,ctrl+alt+j给 JS,ctrl+alt+b给 Python - 别手写“保存即格式化”的复杂绑定——
HTML-CSS-JS Prettify提供勾选开关,JsPrettier不推荐开auto_format_on_save,避免误触污染风格
最常被忽略的是 CLI 工具的 PATH 可访问性与文件语法合法性——它们不出错,也不提示,只是默默跳过。格式化失败时,先查终端能否执行 prettier --version 或 black --version,再确认右下角语言名和代码本身有没有硬性语法错误。











