根本原因是coffee命令不可达或语法识别被覆盖；需检查Sublime控制台PATH是否含npm全局bin路径，硬编码path字段，确保selector为"source.coffee"、cmd匹配系统（Windows用coffee.cmd），并设对文件语法和启用build_on_save。
CoffeeScript 在 Sublime 里不报错、不编译、右下角不显示语法名？根本原因不是插件没装，而是 coffee 命令不可达或语法识别被覆盖。
确认 coffee 命令是否真能被 Sublime 调用
终端里运行 coffee --version 成功 ≠ Sublime 能调用它。Sublime 启动时加载的环境变量和你 shell 的 PATH 可能不同。
- 在 Sublime 中按
Ctrl+`打开控制台，执行import os; print(os.environ.get('PATH'))，检查输出里有没有 npm 全局 bin 路径（如/usr/local/bin、/opt/homebrew/bin或C:\Users\XXX\AppData\Roaming\npm） - 如果没出现，别改系统 PATH——直接在构建系统里用
path字段硬编码，比依赖继承更可靠 - Windows 用户必须用
coffee.cmd，不能只写coffee；macOS/Linux 用户若装的是新版coffeescript包（非coffee-script），命令名仍是coffee，但安装命令得是npm install -g coffeescript
构建系统配置必须匹配文件类型和实际路径
新建构建系统（Tools → Build System → New Build System…）时，以下三点缺一不可：
-
"selector": "source.coffee"—— 这是关键钩子，决定 Sublime 何时自动启用该构建系统；不写或写错（比如写成source.coffeescript）会导致 Ctrl+B 无响应 -
"cmd"要明确指定解释器：Windows 写["coffee.cmd", "-c", "$file"]，macOS/Linux 写["coffee", "-c", "$file"]；加-c是生成 JS 文件，不加则直接运行（适合调试） -
"path"字段填绝对路径，例如 Windows："path": "C:\Users\Alice\AppData\Roaming\npm"；注意双反斜杠；macOS/Linux 示例："path": "/opt/homebrew/bin:/usr/local/bin"
语法高亮失效？大概率是缩进或语法设置被覆盖
右下角没显示 “CoffeeScript”，或者缩进块没颜色分层，常见于：
- 当前文件没设对语法：右下角点开 → 选
CoffeeScript（不是CoffeeScript (Rails)或其他变体）；也可用Ctrl+Shift+P→ 输入Set Syntax: CoffeeScript - 缩进混用 Tab 和空格：
View → Indentation → Convert Indentation to Spaces，再设Tab Width: 2；CoffeeScript 解析器对缩进零容忍，一个 Tab + 三个空格就可能让整块语法高亮崩掉 - 用户级语法配置误删了默认规则：打开
Preferences → Settings – Syntax Specific，确认里面没有手动加的"extensions"或"syntax"覆盖项；这类配置会强行把.coffee文件绑定到别的语法上
保存即编译为什么没反应？两个开关都得打开
Sublime 默认不会监听保存事件触发构建，必须手动开启：
- 确保当前构建系统已激活（
Tools → Build System里选中你刚建的那个，且不是Automatic） - 开启自动构建：菜单
Preferences → Package Settings → Sublime Build → Settings，在右侧用户设置里加一行："build_on_save": true - 注意：只有当前文件语法为
source.coffee且构建系统匹配时，这个开关才生效；否则 Ctrl+S 就只是保存，什么都不会发生
最容易被忽略的是构建系统里的 selector 和文件实际 scope 不一致——比如用了社区维护的 Vue 插件，它可能把 .vue 里 <script lang="coffee"></script> 的 scope 设为 source.coffee.embedded.vue，这时原构建系统就完全失灵。遇到嵌入场景，得单独配 selector 或换用支持嵌入的语法包。
