Sublime需安装Language-CoffeeScript插件实现语法高亮，配置Build System调用coffee命令编译，须统一2空格缩进、禁用detect_indentation，并通过Ctrl+B手动编译以避免缩进错误。
Sublime 安装 CoffeeScript 语法高亮插件
CoffeeScript 在 Sublime Text 中默认不带语法高亮，必须手动安装对应插件。最稳定、维护良好的是官方推荐的 Language-CoffeeScript（原名 SublimeCoffeeScript），它提供完整的 .coffee 文件识别、关键字着色、缩进支持和括号匹配。
安装方式：打开 Command Palette（Ctrl+Shift+P / Cmd+Shift+P），输入 Package Control: Install Package → 回车 → 搜索并选择 Language-CoffeeScript。
- 安装后无需重启，新建或重开
.coffee文件会自动启用高亮 - 若文件未自动识别，右下角状态栏点击当前语法名（如 “Plain Text”），选
CoffeeScript - 注意别装错成已废弃的
CoffeeScript（无 “Language-” 前缀），那个长期未更新，对 ES6+ 风格支持差
Sublime 中运行 CoffeeScript 编译（不依赖 Node CLI）
单纯高亮不够，写完想立刻看 JS 输出，得配编译命令。Sublime 自带 Build System，可调用本地 coffee 命令行工具生成 JS，但前提是系统已全局安装 CoffeeScript：
npm install -g coffeescript
验证是否可用：coffee -v 应输出版本号（2.7.x 或更高）。然后在 Sublime 中新建 Build System：
- 菜单栏 →
Tools→Build System→New Build System… - 替换全部内容为以下 JSON（注意路径适配）：
{
"cmd": ["coffee", "-c", "$file"],
"selector": "source.coffeescript",
"file_regex": "^(...*?):([0-9]+):([0-9]+):? (.*)$",
"variants": [
{
"name": "Compile to JS (watch)",
"cmd": ["coffee", "-cw", "$file"]
}
]
}
- 保存为
CoffeeScript.sublime-build（路径默认是 User 目录） - 之后按
Ctrl+B即可编译当前 .coffee 文件为同名 .js；Ctrl+Shift+B选Compile to JS (watch)可监听修改自动重编译 - Windows 用户若提示
'coffee' is not recognized，需确认 npm 全局 bin 路径已加入系统PATH，或改用绝对路径如"C:\Users\xxx\AppData\Roaming\npm\coffee.cmd"
常见错误：保存后没生成 JS 或报错 “Unexpected indentation”
这类问题通常不是配置导致，而是 CoffeeScript 本身对空白符极其敏感。Sublime 默认缩进设为 4 空格，而 CoffeeScript 要求统一使用空格（不能混 Tab）、且缩进层级必须严格对齐。
- 务必关闭
detect_indentation：在 Sublime 设置（Preferences → Settings）中添加"detect_indentation": false - 强制设为 2 空格缩进（CoffeeScript 社区惯例）：
"tab_size": 2、"translate_tabs_to_spaces": true - 开启显示空白符（
View → Indentation → Show Indent Guide+Show Whitespaces）可快速定位混入的 Tab 或错位空格 - 报错位置常指向“上一行末尾”，因为缩进断裂实际从上一行开始——重点检查
if、for、函数体等块级结构的起始行缩进
要不要装 CoffeeScript 的实时预览插件？
像 SublimeOnSaveBuild 或 AutoFileName 这类插件虽能实现“保存即编译”，但对 CoffeeScript 并不必要，反而容易掩盖缩进问题。更可靠的做法是：
- 专注写好语法正确的 .coffee，靠
Ctrl+B主动触发编译，看清终端报错位置 - 搭配浏览器开发者工具 Source Map（需加
-m参数）调试原始 CoffeeScript，而不是依赖插件模拟执行 - 真正需要自动化时，用
npm run watch配合coffee -cw更稳定，Sublime 只负责编辑
语法高亮只是起点，CoffeeScript 的缩进语义和隐式返回特性，才是日常踩坑最多的地方——配再花哨的插件，也救不了少敲一个空格。
