必须装Language CoffeeScript插件，而非CoffeeScript或SublimeCoffeeScript；安装后需手动将.coffee文件关联为CoffeeScript语法，并统一设为2空格缩进且转为空格，否则无法高亮。
装哪个插件才能让.coffee文件真正高亮？
必须装 Language CoffeeScript，不是 CoffeeScript 或 SublimeCoffeeScript。后者是旧版、多年未更新，语法定义已失效，装了反而导致右下角显示 Plain Text、关键词全黑、缩进无分层。
安装方式：按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS）→ 输入 Install Package → 等列表加载完 → 搜索并选中 Language CoffeeScript → 回车。装完不用重启，但已有 .coffee 文件需重开或手动重载语法。
- 确认是否生效：打开任意 .coffee 文件，右下角状态栏必须显示
CoffeeScript；若显示Plain Text或JavaScript，说明插件没起作用 - 别手动放
CoffeeScript.tmLanguage：Sublime Text 3/4 已弃用该格式，硬塞进去会和Language CoffeeScript冲突 - 如果装完仍不亮，检查
Packages/User/下有没有残留的旧插件目录（如CoffeeScript/），直接删掉
为什么右下角明明写了“CoffeeScript”，但缩进还是报错？
CoffeeScript 对空白符极其敏感，Sublime 一旦混用 Tab 和空格、或缩进宽度≠2，语法解析器就会放弃高亮——表现为关键词变黑、缩进颜色消失、甚至右下角自动跳回 Plain Text。
必须统一为 2 空格缩进：
- 菜单 →
View → Indentation → Convert Indentation to Spaces - 再点
Indentation → Tab Width: 2 - 在
Preferences → Settings用户设置里加"detect_indentation": false，防止编辑器自作主张改缩进 - 已有文件改完后需关闭再重开，或按
Ctrl+Shift+P→ 输入Reload Syntax回车
构建系统里 coffee 命令总找不到？别信 PATH
Sublime 的构建系统不继承终端的 PATH，你在 CMD/PowerShell 里能跑 coffee --version，不代表 Sublime 能调到它。必须显式指定路径，且 Windows 必须用 coffee.cmd。
先查真实路径：
- Windows：CMD 里运行
where coffee，结果类似C:UsersliceAppDataRoaming pmcoffee.cmd - macOS/Linux：终端运行
which coffee，结果类似/usr/local/bin/coffee - Sublime 控制台（
Ctrl+`）里运行import os; print(os.environ.get('PATH'))，确认输出里有上述路径
构建系统 JSON 示例（Windows）：
{
"cmd": ["C:\Users\alice\AppData\Roaming\npm\coffee.cmd", "-c", "$file"],
"selector": "source.coffee",
"file_regex": "^(.*?):([0-9]+):([0-9]+):? (.*)$"
}
-
cmd中所有反斜杠必须双写（\），否则 JSON 解析失败 - 不要加
"shell": true，它会让 Sublime 启动 cmd.exe，增加出错概率 -
file_regex必须匹配实际报错格式（新版coffee -c输出是file:line:column: message）
保存文件后想自动编译？Sublime 不自带这功能
默认按 Ctrl+B 才触发构建，Sublime 本身不监听文件保存事件。要实现“保存即编译”，得靠第三方插件：
- 装
SublimeOnSaveBuild：命令面板输入Install Package→ 搜它 → 安装 - 装完后，进
Preferences → Package Settings → SublimeOnSaveBuild → Settings - 在用户设置里加：
{ "build_on_save": true, "build_on_save_types": ["source.coffee"] } - 注意：它只触发你当前选中的构建系统，务必先在
Tools → Build System里选好你的CoffeeScript.sublime-build
真正容易被忽略的是：即使所有配置都对，只要右下角没显示 CoffeeScript，后续所有构建、缩进、高亮都会静默失效——它不是“可选项”，而是整个流程的开关。
