sublime text 编译 coffeescript 需先全局安装 coffee 命令（npm install -g coffeescript），确保其在 path 中并能终端调用；再手动配置 build system 指向 coffee 可执行文件，参数如 -c 用于编译、-cw 用于监听，注意路径、缩进和编码问题。
Sublime Text 本身不内置 CoffeeScript 编译能力，必须通过插件 + 外部 coffee 命令行工具协同工作；如果编译失败，90% 的情况是 coffee 没装好、没加进系统 PATH，或插件配置没指向正确的可执行路径。
确认本地已安装并可调用 coffee 命令
CoffeeScript 编译器必须以 Node.js 为运行环境，coffee 是全局 npm 包，不是 Sublime 插件自带的。跳过这步直接装插件，必然报 Unable to find command "coffee" 或 command not found 错误。
- 终端运行
coffee -v，应输出类似CoffeeScript version 2.7.0 - 若提示命令未找到，先确认 Node.js 已安装（
node -v），再执行npm install -g coffeescript（注意：v2+ 版本包名是coffeescript，不是旧版的coffee-script） - Windows 用户特别注意：npm 全局 bin 目录（如
C:\Users\XXX\AppData\Roaming\npm）必须加入系统环境变量PATH，否则 Sublime 启动时读不到该命令
安装 Build System 插件（推荐 SublimeCodeIntel 或纯 Build System）
不需要“CoffeeScript 官方插件”——它只提供语法高亮和简单补全，不负责编译。真正要的是能调用 coffee 命令的构建系统。
- 推荐手动配置 Build System：菜单 → Tools → Build System → New Build System…，粘贴以下内容并保存为
CoffeeScript.sublime-build - Linux/macOS 示例：
{ "cmd": ["coffee", "-c", "$file"], "selector": "source.coffee", "file_regex": "^([^:]+):([0-9]+):([0-9]+):(.*)$" } - Windows 示例（需显式指定
coffee.cmd）：{ "cmd": ["coffee.cmd", "-c", "$file"], "selector": "source.coffee", "file_regex": "^([^:]+):([0-9]+):([0-9]+):(.*)$" } - 保存后，在当前 .coffee 文件中按
Ctrl+B（Win/Linux）或Cmd+B（macOS），即可生成同名 .js 文件
coffee 命令常用参数与实际用途匹配
Build System 中的 "cmd" 字段决定了编译行为，不同参数对应不同开发场景，别盲目套用默认值。
-
-c（compile）：生成单个 JS 文件（最常用） -
-cw（watch）：监听文件变化自动重编译（适合长期开发，但 Sublime 默认 Build 不支持后台持续运行；需改用subl .启动项目 + 终端单独跑coffee -cw src/） -
-o ./dist：指定输出目录（配合-c使用，避免 JS 和 CS 文件混在一起） -
-b（bare）：不包裹 IIFE（即不加(function() { … })();），适合模块化或浏览器全局脚本 - 错误提示格式依赖
file_regex：上面示例中的正则仅适配 v2.x 输出；若用 v1.x，错误格式是error: <message> on line <n></n></message>，需换正则，否则跳转不到出错行
常见报错与绕过方案
即使 coffee -v 成功，Sublime 编译仍可能失败，核心原因在于 Sublime 的构建环境 PATH 与终端不一致（尤其 macOS GUI 启动时）。
-
Unable to find command "coffee"：不是插件问题，是 PATH 缺失。macOS 可在 Build System 中硬编码路径，例如"/usr/local/bin/coffee"；Linux 查which coffee；Windows 查where coffee.cmd - 编译成功但无输出文件：检查当前文件是否已保存（
$file是完整路径，未保存的临时文件无法被coffee读取） - 语法正确却报错“unexpected indentation”：CoffeeScript 对空格极其敏感，确保用空格缩进（非 Tab），且 Sublime 设置中
"detect_indentation": true，并确认右下角显示 “CoffeeScript” 且缩进为 “Spaces: 2” - 中文路径下编译失败：Node.js 旧版本对 UTF-8 路径支持差，升级 Node.js 至 v16+ 可缓解
真正卡住的点往往不在 Sublime 配置本身，而在 coffee 命令能否被它的子进程干净调用——建议先在终端用完全相同的命令测试，再挪进 Build System。路径、权限、Node 版本、全局安装方式，每个环节都可能断链。
