Sublime Text 本身不能自动排版,所有「保存即整齐」「一键重排结构」效果均依赖外部 CLI 工具(如 prettier、black、gofmt)加插件桥接实现;reindent 仅做缩进对齐,不重构语法结构,且需语法识别正确、缩进统一、禁用 trim_automatic_whitespace 才生效。

Sublime Text 本身不能自动排版,所有「保存即整齐」「一键重排结构」的效果,都依赖外部 CLI 工具(如 prettier、black、gofmt)+ 插件桥接实现;没装对工具、路径不对、语法识别错、配置漏项,任意一环断掉,格式化就静默失败。
为什么 reindent 不是自动排版
reindent 是 Sublime 内置命令,只做缩进对齐:它不改括号位置、不调整二元运算符换行、不统一引号类型、不处理空行逻辑。它只在以下条件全满足时才“看起来有效”:
- 右下角状态栏显示的是正确语法(如
JavaScript,不是Plain Text) - 文件缩进风格统一(全空格或全 Tab),且已通过
View → Indentation → Convert Indentation to Spaces转换过 - 设置里
"trim_automatic_whitespace": false,否则格式化后末尾空格会被悄悄删掉
JsPrettier 格式化 JS/TS/JSON 的硬性前提
装了插件 ≠ 能用。它本质是调本地 prettier CLI,必须同时满足:
-
node -v和prettier --version在终端能正常返回 —— 如果不行,先装 Node.js 并确保npm install -g prettier - Sublime 控制台执行
import subprocess; subprocess.run(['prettier', '--version'])也得成功;若报command not found,说明 Sublime 没读到你的$PATH,macOS/Linux 需在Preferences → Settings – User里显式加"path": "/opt/homebrew/bin:/usr/local/bin",Windows 要确认C:\Users\XXX\AppData\Roaming\npm已进系统环境变量并重启编辑器 -
prettier_cli_path配置必须填绝对路径(如/usr/local/bin/prettier或C:\Users\xxx\AppData\Roaming\npm\prettier.cmd),别信“自动检测” -
use_stdin建议设为true,避免 BOM 或编码问题导致解析失败
sublime_black 格式化 Python 的关键点
别用 autopep8,它对 def f(x: str) -> None: 或 f"hello {name}" 容易直接报 invalid syntax;Black 是目前最稳的选择:
- 终端运行
pip install black,验证black --version可执行 - 插件名是
sublime_black(不是Black或python-black),通过 Package Control 安装 - 默认快捷键
Ctrl+Shift+K容易和系统冲突,建议手动绑定:Preferences → Key Bindings用户侧加一行:{ "keys": ["ctrl+alt+b"], "command": "black" } - 如果格式化后缩进变 2 空格或报错,检查是否项目根目录有
pyproject.toml且含[tool.black]配置 ——sublime_black会读它,但没配就走默认(4 空格)
保存自动格式化(format_on_save)为什么总失效
开这个开关前必须过三关,少一关就白配:
-
format_on_save_extensions必须精确匹配扩展名:写["js", "ts"],但文件是.tsx就不会触发;Vue 单文件组件要额外加"vue" -
format_on_save_excludes的 glob 写法不是 shell 风格:"**/node_modules/**"有效,"node_modules/*"无效 - 插件配置里
auto_format_on_save默认是false,得手动设为true;但更推荐保持关闭,用快捷键手动触发,避免保存时意外破坏团队约定风格
最常被忽略的其实是「语法识别」——哪怕你打开的是 script.ts,只要右下角显示 Plain Text,所有格式化命令都不会启动。点一下状态栏手动切对语言,比反复重装插件管用十倍。


















