Sublime如何设置文件保存时自动格式化？（工作流优化）

sublime text 原生不支持保存自动格式化，需依赖插件：前端用 jsprettier（调用本地 prettier），python 用 sublime-code-formatter + black；均需正确安装对应可执行文件并配置触发开关与排除路径，且仅对匹配语法类型的文件生效。

sublime text 保存时自动格式化靠插件，原生不支持

Sublime Text 本身没有内置「保存即格式化」功能，必须依赖第三方插件。最常用、维护活跃的是 JsPrettier（前端）和 Sublime-Code-Formatter（多语言），但它们行为逻辑不同，选错容易白配。

关键判断：你用什么语言？有没有本地 prettier / black / clang-format 可执行文件？没装就别硬配——插件会直接报错 File not found: prettier 或静默失效。

• 前端项目（JS/TS/HTML/CSS）优先用 JsPrettier，它调用本地 prettier，配置直观
• Python 项目建议用 Sublime-Code-Formatter + black，它对 black 的参数兼容性更好
• 如果混用多种语言，Sublime-Code-Formatter 支持按 scope 绑定不同 formatter，但需手动写 settings 文件

JsPrettier 保存自动格式化的最小可行配置

JsPrettier 默认不监听保存事件，必须手动开启。打开插件设置（Preferences → Package Settings → JsPrettier → Settings），在右侧面板加这三行：

{   "auto_format_on_save": true,   "auto_format_on_save_excludes": ["*/node_modules/*", "*/dist/*"],   "allow_inline_js": false }

注意点：

• auto_format_on_save_excludes 必须设，否则保存 node_modules 下的文件会卡死或报错
• 如果项目用了 prettier.config.js，确保它在项目根目录，JsPrettier 默认会向上查找
• 格式化失败时，控制台（Ctrl+`）会打印具体错误，常见是 prettier 版本太低不支持某语法，升级即可

Sublime-Code-Formatter 的 Python 自动格式化陷阱

这个插件默认不启用保存触发，且 Python 后端默认用 autopep8，但多数人实际想用 black。必须显式指定：

打开 Preferences → Package Settings → Sublime Code Formatter → Settings，填入：

{   "code_formatting_engine": "black",   "format_on_save": true,   "format_on_save_timeout_ms": 3000 }

容易踩的坑：

• black 必须已安装在系统 PYTHONPATH 能找到的位置，推荐用 pip install black --user
• format_on_save_timeout_ms 建议设为 3000，否则大文件保存时可能被中断，不报错也不格式化
• 它不识别 pyproject.toml 里的 [tool.black] 配置，得额外配 black_options 字段

保存格式化不是万能的，有些场景必须关掉

自动格式化在某些工作流里反而坏事。比如：

• 编辑别人写的遗留代码时，一保存就重排整个文件，git diff 全是格式变更，掩盖真实逻辑修改
• 写 JSX 或 Vue 模板时，prettier 可能强行折行，破坏你刻意对齐的 props 结构
• 团队没统一 prettier 版本，你本地格式化后，CI 流水线用旧版检查失败

这时建议用快捷键替代自动保存：给 JsPrettier 绑定 ctrl+alt+f，或把 format_on_save 设为 false，只在确认要提交前手动格式化一次。

最常被忽略的一点：所有插件的「保存即格式化」都只作用于当前视图的语法类型（由右下角显示的 JavaScript / Python 决定），如果你用 Plain Text 模式开一个 .js 文件，它根本不会触发。