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 版本、全局安装方式，每个环节都可能断链。