Sublime Text 通过 SublimeOnSaveBuild 插件配合自定义构建系统实现保存即编译;需先安装插件、配置对应语言的 .sublime-build 文件并手动选择一次构建系统,再设置文件扩展名白名单即可自动触发编译。

Sublime Text 本身不内置“保存即编译”功能,但可以通过组合「构建系统」+「插件」或「事件监听」实现。最稳定、轻量的方式是使用 SublimeOnSaveBuild 插件,配合自定义构建系统(如 Python、Less、TypeScript 等)即可自动触发编译。
安装 SublimeOnSaveBuild 插件
这是实现“保存即编译”的核心插件,它会在你按下 Ctrl+S(或 Cmd+S)时,自动调用当前文件关联的构建系统:
- 打开 Command Palette(Ctrl+Shift+P / Cmd+Shift+P),输入 Install Package,回车后选择 Package Control: Install Package
- 搜索并安装 SublimeOnSaveBuild
- 安装完成后无需重启,插件立即生效
配置匹配的构建系统(.sublime-build)
插件只负责“触发”,真正执行编译的是你为对应语言设置的构建系统。以编译 TypeScript 为例:
- 菜单栏 → Tools → Build System → New Build System…
- 替换内容为:
{
"cmd": ["tsc", "$file"],
"selector": "source.ts",
"file_regex": "^(.*\\.ts)\\:(\\d+)\\:(\\d+)\\:\\s+(.*)$",
"working_dir": "$file_path"
}
- 保存为 TypeScript.sublime-build(路径默认在
Packages/User/) - 然后通过 Tools → Build System → TypeScript 手动选中一次,后续保存 .ts 文件就会自动调用 tsc 编译
控制哪些文件类型启用自动编译
SublimeOnSaveBuild 默认对所有有构建系统的文件生效,可通过设置精细控制:
- 菜单栏 → Preferences → Package Settings → SublimeOnSaveBuild → Settings
- 在用户设置中添加白名单,例如只对 .ts 和 .less 文件生效:
{
"extensions": ["ts", "less"]
}
- 也可加
"excluded_extensions": ["md", "txt"]排除干扰类型
常见问题与提示
自动编译不是万能的,需注意几点:
- 构建命令必须可被系统识别(如
tsc、lessc需已全局安装并加入 PATH) - 若构建失败,Sublime 会弹出错误面板,不影响保存;可按 Ctrl+Shift+B 手动重试
- 想临时禁用自动构建?快捷键 Ctrl+Alt+B(Windows/Linux)或 Cmd+Alt+B(macOS)可一键开关
- 不推荐对大型项目开启“保存即全量构建”,建议构建脚本里用增量编译(如
tsc --watch配合文件监听更高效)
基本上就这些。不复杂但容易忽略的是:构建系统必须先手动选中一次,插件才能识别上下文。设好之后,写完代码一保存,编译就静默完成了。










