Sublime Text 本身无自动排版功能,所有“一键格式化”均依赖插件,必须先成功安装Package Control,再按语言选用JsPrettier(JS/TS/JSON)、sublime_black(Python)或HTML-CSS-JS Prettify(HTML/CSS),并确保语法模式正确、CLI工具路径配置无误、代码合法,否则静默失效。

Sublime Text 本身不带自动排版功能,所有“一键格式化”都依赖插件,且必须按语言选对插件、配好运行环境,否则快捷键按烂也没反应。
Package Control 装不上,后面全卡死
按 Ctrl+Shift+P 输 Install Package 没反应?不是网慢,是 Package Control 根本没装成。
- 必须先按
Ctrl+`(Esc 下方)打开控制台,粘贴官网最新 HTTPS 安装脚本(旧的http://sublime.wbond.net已失效) - 执行后看到
Success! Please restart Sublime Text...才算通过校验;只显示import报错或空白,说明脚本未执行或哈希不匹配 - 装完必须彻底退出:Windows 查任务管理器杀光所有
subl.exe,macOS 用 Activity Monitor 结束进程,再重开 - 重启后再次按
Ctrl+Shift+P输入Package Control:,能下拉出选项才算真正就位
按语言装对插件,别搜“格式化”三个字
JavaScript/TS/JSON 用 JsPrettier,Python 用 sublime_black,HTML/CSS 用 HTML-CSS-JS Prettify——混装或乱搜名字(比如输 prettierCLI 或 beautify)大概率失败。
-
JsPrettier要求系统已全局安装prettier:npm install -g prettier,并在插件设置里填对prettier_cli_path(Windows 必须带.cmd后缀,如"C:\Users\xxx\AppData\Roaming\npm\prettier.cmd") -
sublime_black要求已运行pip install black,且设置中"use_stdin": true必须为true,否则只处理保存后的文件,不支持选中文本实时格式化 -
Pretty JSON只认合法 JSON:单引号、尾随逗号、//注释都会让它静默跳过,不报错也不提示
格式化没反应?先看右下角语法模式
右下角显示 Plain Text 时,几乎所有格式化命令都灰显或无响应——Sublime 不会自动猜语言,必须人工指定。
- 点击右下角语言名,手动选成
JavaScript、Python、JSON或HTML - 或直接把文件保存为对应后缀(如
.js、.py、.json),让编辑器自动切换 - 如果文件里混着非目标内容(比如日志文本里夹一段 JSON),务必先手动框选那段,再触发格式化;否则插件直接跳过整文件
- 快捷键冲突常见于
Emmet或SideBarEnhancements,打开Preferences → Key Bindings,检查右侧用户配置是否覆盖了默认快捷键(如Ctrl+Alt+Shift+P)
最常被忽略的一点:插件装完 ≠ 立刻可用。每种插件都强依赖外部命令行工具(prettier、black、js-beautify 等)的存在和路径可达性,且 ST4 对路径解析更严格——相对路径、空格、权限问题都会导致静默失败,查不到错误日志,只能靠控制台输出和插件状态栏提示定位。


















