Sublime Text 的 CoffeeScript 插件无反应，主因是系统未正确配置 coffee 命令行工具：需全局安装 coffeescript、将其路径加入 PATH，并在 Sublime 构建系统中手动指定 cmd 和 path；同时确保文件语法设为 CoffeeScript、启用 save_on_build 且禁用冲突插件。
Sublime Text 装了 CoffeeScript 插件却没反应？先确认 CoffeeScript 命令是否在系统 PATH 里
Sublime 的 CoffeeScript 编译依赖外部 coffee 命令行工具，不是插件自带的。如果按教程装了插件但保存不编译、右键没菜单、快捷键无效，大概率是 coffee 命令根本找不到。
打开终端（macOS/Linux）或命令提示符（Windows），运行：
coffee --version
如果报错 'coffee' is not recognized as an internal or external command 或 command not found，说明 Node.js 的全局 bin 路径没进系统 PATH，或者根本没装 coffee。
- Mac/Linux：用
npm install -g coffeescript（注意新版包名是coffeescript，不是coffee-script） - Windows：确保 npm 全局安装路径（如
C:UsersXXXAppDataRoaming pm）已加入系统环境变量PATH - 验证路径：在 Sublime 中按
Ctrl+`打开内置控制台，输入import os; print(os.environ.get('PATH'))，看输出里有没有 npm 全局 bin 路径
Sublime 的 CoffeeScript 构建系统找不到 coffee？手动指定 path 或改用 cmd
即使终端能跑 coffee，Sublime 内置构建系统可能仍找不到它——因为 Sublime 启动时读取的是它自己的环境变量，不一定继承你 shell 的 PATH。
解决方法不是重装插件，而是编辑构建系统配置：
- 菜单栏 →
Tools→Build System→New Build System… - 替换成以下内容（macOS/Linux 示例）：
{
"cmd": ["coffee", "-c", "$file"],
"selector": "source.coffee",
"path": "/usr/local/bin:/opt/homebrew/bin"
}
Windows 用户把 cmd 改成：
"cmd": ["coffee.cmd", "-c", "$file"]
path 字段填你 npm 全局 bin 的绝对路径（比如 C:\Users\XXX\AppData\Roaming\npm），注意双反斜杠；cmd 直接写完整命令名更稳妥，避免 PATH 查找失败。
保存自动编译不生效？检查文件类型和构建系统是否匹配
Sublime 不会“自动”编译，它只在你触发构建（Ctrl+B）或启用“保存时自动构建”后才执行。而“保存即编译”需要两个条件同时满足：
- 当前文件语法必须设为
CoffeeScript（右下角状态栏点开选，或Ctrl+Shift+P→Set Syntax: CoffeeScript） - 当前激活的构建系统必须是 CoffeeScript 相关的（菜单
Tools → Build System里选对了，且不是Automatic） - 插件本身不提供“保存即编译”功能，得靠 Sublime 自带的
save_on_build设置：在Preferences → Settings – User里加一行："save_on_build": true
如果用了第三方插件如 SublimeOnSaveBuild，它可能覆盖默认行为，反而导致冲突——这种插件建议卸载，纯用 Sublime 原生构建系统更可控。
编译出错但没提示？重点看 stderr 和 .map 文件生成逻辑
CoffeeScript 编译失败时，Sublime 默认只显示 stdout（比如成功信息），而错误堆栈在 stderr。如果构建面板一闪而过没看到报错，说明错误被吞了或没输出。
- 在构建系统配置里加上
"quiet": false，强制显示所有输出 - 加
"variants"区分开发/生产模式，比如加个 watch 变体："cmd": ["coffee", "-cw", "$file_base_name"]（注意这会常驻进程，别重复运行） - 生成
.map文件需显式加-m参数：["coffee", "-cm", "$file"]，否则调试时看不到源码映射 - 路径含中文或空格？
$file会被自动加引号，但某些旧版coffee不兼容，可改用$file_path/$file_base_name拆解拼接
真正卡住的地方往往不是语法，而是路径解析、编码（比如 BOM 头）、或 Node.js 版本太新导致 coffee 不兼容——2.7.x 之后的 CoffeeScript 对 ES 模块支持有限，老项目建议锁死 coffeescript@2.6.1。
