必须安装Language CoffeeScript插件（作者jashkenas），而非已废弃的CoffeeScript或SublimeCoffeeScript；安装后需手动绑定.coffee文件语法为CoffeeScript、统一设为2空格缩进并禁用自动探测，同时构建系统须显式指定coffee命令绝对路径（Windows用coffee.cmd），任一环节出错则文件仅显示为纯文本。
语法高亮和即时编译在 Sublime Text 里是两件事：高亮靠 Language CoffeeScript 插件 + 正确语法绑定 + 严格缩进；编译靠构建系统调用本地 coffee 命令，且路径必须显式指定——二者任一环节出错，.coffee 文件就只是纯文本。
装哪个插件才让.coffee文件真正被识别？
只装 Language CoffeeScript（作者 jashkenas），别碰 CoffeeScript 或 SublimeCoffeeScript。后两者用的是已弃用的 .tmLanguage 格式，在 Sublime Text 3/4 上根本不会触发高亮，右下角永远显示 Plain Text。
- 按
Ctrl+Shift+P→ 输入Install Package→ 等列表加载完 → 搜索并安装Language CoffeeScript - 装完立刻检查：打开任意
.coffee文件，右下角必须显示CoffeeScript；若仍是Plain Text，去Packages/User/手动删掉残留的CoffeeScript/目录 - 别手动丢
CoffeeScript.tmLanguage文件进Packages——它会和Language CoffeeScript冲突
为什么右下角刚设成CoffeeScript，一敲回车又变回Plain Text？
Sublime 不靠后缀自动绑定语法，尤其对空文件或无 shebang 的文件，默认跳过识别逻辑。手动设置不是“一次搞定”，而是每次新建文件都得重来。
- 新建
.coffee文件后，务必点击右下角状态栏 → 选CoffeeScript - 再点菜单
View → Syntax → Open all with current extension as…→ 确认弹窗中.coffee已关联到CoffeeScript - 已有文件改完后需关闭重开，或按
Ctrl+Shift+P→ 输入Reload Syntax回车 - 进
Preferences → Settings – Syntax Specific，确认里面没写死"syntax"或"extensions"字段
缩进一动，高亮全丢、关键词变黑，怎么办？
CoffeeScript 语法解析器对空白符零容忍：混用 Tab 和空格、缩进宽度 ≠ 2，它直接放弃渲染，退化为 Plain Text。
- 菜单
View → Indentation → Convert Indentation to Spaces - 再点
Indentation → Tab Width: 2 - 在
Preferences → Settings（用户设置）里加一行："detect_indentation": false，禁用自动探测 - 改完设置后，已打开的文件必须重载语法（
Ctrl+Shift+P→Reload Syntax）或关闭重开
Ctrl+B 编译报 Unable to find command coffee 怎么办？
Sublime 构建系统不读你终端的 PATH。你在命令行能跑 coffee --version，不代表它能找到 coffee。
- 先查真实路径：Windows 运行
where coffee，macOS/Linux 运行which coffee - Windows 构建系统里
"cmd"必须写"coffee.cmd"，"path"填绝对路径，比如"C:\Users\xxx\AppData\Roaming\npm" - macOS/Linux 在构建系统 JSON 中加
"path": "/usr/local/bin:/opt/homebrew/bin" - 别用
"shell": true——它会让 Sublime 启动cmd.exe或sh，反而增加失败概率
最易被忽略的点是：语法高亮正常 ≠ 构建能跑。哪怕右下角稳稳显示 CoffeeScript，只要构建系统里的 path 没对上、或者 Windows 下漏了 .cmd 后缀，Ctrl+B 就静默失败或报找不到命令。
