CoffeeScript在Sublime中保存即编译需构建系统、手动激活及.coffee文件类型三者协同；常见失败源于coffee命令不可用、构建系统未选中或缩进不一致。
CoffeeScript 在 Sublime 里保存即编译，不是靠插件“自动”实现的，而是靠构建系统 + 正确激活 + 文件类型匹配三者协同——缺一不可。大部分失败案例，都卡在 coffee 命令找不到，或构建系统没被真正选中。
确认 coffee 命令是否可用且路径正确
Sublime 的构建系统不继承你终端的 PATH，即使 coffee --version 在命令行能跑，Sublime 内部仍可能报 'coffee' is not recognized 或直接静默失败。
- Windows 用户优先用
coffee.cmd全路径，例如："cmd": ["C:\Users\Alice\AppData\Roaming\npm\coffee.cmd", "-c", "$file"] - macOS/Linux 用户建议显式加
path字段，比如："path": "/opt/homebrew/bin:/usr/local/bin"（别依赖$PATH） - 验证方式：Sublime 中按
Ctrl+`打开控制台，运行import os; print(os.environ.get('PATH'))，看输出里有没有 npm 全局 bin 路径
构建系统必须手动指定，不能依赖 Automatic
Sublime 的 Automatic 构建系统不会主动识别 .coffee 文件并绑定 CoffeeScript 构建规则——它只认语法 scope 和你当前选中的构建系统。
- 右下角状态栏必须显示
CoffeeScript（点击可切换），否则selector匹配失败 - 菜单
Tools → Build System必须手动选中你刚建的Coffee（不是Automatic） - 文件名必须以
.coffee结尾；如果临时改后缀测试，记得重设语法（Ctrl+Shift+P→Set Syntax: CoffeeScript）
启用保存即编译需两步同时生效
Sublime 本身不提供“保存即构建”开关，得靠第三方插件或手动触发 + 配置监听模式。但注意：coffee -w 不是标准选项，新版 coffeescript 包已移除 watch 功能。
- 推荐方案：安装
LiveBuild插件，然后在Preferences → Package Settings → LiveBuild → Settings – User中添加：
{
"builders": [
{
"selector": "source.coffee",
"cmd": ["coffee", "-c", "$file"],
"working_dir": "$file_path"
}
]
}
- 不装插件？那就只能按
Ctrl+B手动构建，别指望保存自动触发 - 别写
"cmd": ["coffee", "-cw", "$file"]—— 这会报错，-w已废弃
缩进和空格不一致会导致语法高亮失效甚至构建中断
CoffeeScript 编译器对缩进极其敏感，而 Sublime 的渲染层也会据此降级处理：一旦检测到混用 Tab 和空格，就可能放弃语法着色，连带构建系统无法正确识别 scope。
- 务必执行
View → Indentation → Convert Indentation to Spaces - 再设
Indentation → Tab Width: 2（CoffeeScript 社区惯例） - 检查右下角是否稳定显示
CoffeeScript，且缩进有颜色分层；若只是灰白一片，大概率是缩进格式问题
最常被忽略的一点：构建系统文件名必须以 .sublime-build 结尾，且保存在 Packages/User/ 目录下（不是 Packages/CoffeeScript/）。放错位置，Sublime 根本不会加载它。
