Sublime Text需手动设置语法为CoffeeScript并统一2空格缩进，否则无法高亮或编译；构建系统须显式指定coffee.cmd路径且匹配当前语法，二者缺一不可。
Sublime Text 本身不带 CoffeeScript 支持，语法高亮必须靠外部插件+正确文件关联，否则打开 .coffee 文件就是纯文本，缩进错乱、关键词不着色、右下角不显示 “CoffeeScript”——这不是插件没装，而是配置断在了关键环节。
如何确认当前文件被识别为 CoffeeScript？
右下角状态栏必须显示 CoffeeScript，否则所有后续构建、缩进、高亮都无效。常见假象是：文件后缀是 .coffee，但 Sublime 实际用的是 Plain Text 或 JavaScript 语法解析。
- 手动触发：按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Set Syntax: CoffeeScript回车 - 检查是否被覆盖：进入
Preferences → Settings – Syntax Specific，确认里面没有"extensions"或"syntax"字段强行指定了其他语法 - 新建文件时默认不继承：即使你刚编辑过一个
.coffee文件，新标签页仍可能用默认语法，务必每次新建后手动设一次
为什么缩进总报错、高亮突然消失？
CoffeeScript 对空白符极度敏感，Sublime 若混用 Tab 和空格，或缩进宽度不统一，语法包会直接放弃解析——表现为关键词变黑、缩进无颜色分层、甚至右下角语法名自动跳回 Plain Text。
- 必须统一用空格：菜单
View → Indentation → Convert Indentation to Spaces - 必须设为 2 空格：再点
Indentation → Tab Width: 2 - 禁用 Tab 插入：在
Preferences → Settings中确保"detect_indentation": false，避免编辑器自作主张重设 - 已有文件需重载：改完设置后，关闭再重新打开
.coffee文件，或按Ctrl+Shift+P → Reload Syntax
构建系统里 coffee 命令找不到怎么办？
语法高亮正常 ≠ 构建能跑。Sublime 的构建系统启动时读取的是它自己的环境变量，和终端的 PATH 不一定一致。你在终端能跑 coffee --version，不代表 Sublime 能调到它。
- 先查路径：按
Ctrl+`打开 Sublime 控制台，运行import os; print(os.environ.get('PATH'))，确认输出里有 npm 全局 bin 路径（如/usr/local/bin或C:\Users\xxx\AppData\Roaming\npm） - Mac/Linux：在构建系统 JSON 中显式加
"path": "/usr/local/bin:/opt/homebrew/bin" - Windows：
"cmd"必须写"coffee.cmd"（不是coffee），且"path"填绝对路径，比如"C:\Users\xxx\AppData\Roaming\npm" - 别信 “Automatic” 构建系统：必须手动在
Tools → Build System中选中你刚建的那个CoffeeScript.sublime-build
保存即编译不生效？两个开关缺一不可
Sublime 不会“监听保存自动触发”，它只响应明确的构建动作。所谓“保存即编译”，本质是开启了一个隐藏开关，并依赖当前上下文完全匹配。
- 先打开自动构建：菜单
Tools → Build System → Save and Build（注意不是 “Build on Save” 插件） - 但仅此不够：当前文件语法必须是
CoffeeScript，且激活的构建系统必须是你配好的 CoffeeScript 构建系统（不能是 Automatic 或其他语言） - 验证方式：改一行代码 →
Ctrl+S→ 看底部面板是否弹出编译结果或错误；若静悄悄，说明任一条件未满足
最常被忽略的是：语法识别和构建系统是两套独立机制，它们之间没有自动联动。你可能花了半小时调通构建命令，却因为右下角一直显示 “Plain Text”，导致所有努力白费。
