Sublime怎么配置CoffeeScript环境？Sublime编写CS脚本高亮

Sublime需安装Language-CoffeeScript插件实现语法高亮，配置Build System调用coffee命令编译，须统一2空格缩进、禁用detect_indentation，并通过Ctrl+B手动编译以避免缩进错误。

Sublime 安装 CoffeeScript 语法高亮插件

想在 Sublime Text 里优雅地编写 CoffeeScript，第一步就是解决语法高亮问题。毕竟，Sublime 默认并不支持 .coffee 文件。目前最稳妥的选择，是安装官方推荐的 Language-CoffeeScript 插件（原名 SublimeCoffeeScript）。这个插件维护得不错，能提供完整的关键字着色、缩进提示和括号匹配功能。

安装方法很简单：打开命令面板（Ctrl+Shift+P 或 Cmd+Shift+P），输入 Package Control: Install Package 并回车，然后搜索 Language-CoffeeScript 选中即可。

• 安装后通常无需重启，新建或重新打开一个 .coffee 文件，高亮就会自动生效。
• 如果没识别出来，可以留意编辑器右下角的状态栏，点击当前的语法名称（比如“Plain Text”），手动选择 CoffeeScript。
• 这里有个小坑要注意：别装错了。仓库里还有一个名字很像但已废弃的 CoffeeScript 插件（没有“Language-”前缀），那个版本老旧，对现代 ES6+ 风格的代码支持很差。

Sublime 中运行 CoffeeScript 编译（不依赖 Node CLI）

光有高亮还不够，写完了总得看看编译出来的 Ja vaScript 是什么样子吧？这时候就需要配置 Sublime 的编译系统了。Sublime 自带的 Build System 功能，可以直接调用本地的 coffee 命令行工具来生成 JS 文件。当然，前提是你的系统已经全局安装了 CoffeeScript：

npm install -g coffeescript

安装后，在终端里输入 coffee -v 能输出版本号（比如 2.7.x 或更高），就说明环境准备好了。接下来在 Sublime 里新建一个编译系统：

• 点击菜单栏的 Tools → Build System → New Build System…。
• 把编辑器里全部内容替换成下面这段 JSON 配置（注意根据你的系统调整路径）：

{
  "cmd": ["coffee", "-c", "$file"],
  "selector": "source.coffeescript",
  "file_regex": "^(...*?):([0-9]+):([0-9]+):? (.*)$",
  "variants": [
    {
      "name": "Compile to JS (watch)",
      "cmd": ["coffee", "-cw", "$file"]
    }
  ]
}

• 把它保存为 CoffeeScript.sublime-build（文件通常会默认保存在 User 目录下）。
• 配置好后，打开一个 .coffee 文件，按 Ctrl+B 就能立即编译出同名的 .js 文件。如果想监听文件变动自动编译，可以按 Ctrl+Shift+B，然后选择 Compile to JS (watch) 这个变体。
• Windows 用户如果遇到 'coffee' is not recognized 的错误，大概率是 npm 的全局路径没加到系统环境变量 PATH 里。要么去配置环境变量，要么在配置里改用 coffee.cmd 的绝对路径，比如 "C:\Users\xxx\AppData\Roaming\npm\coffee.cmd"。

常见错误：保存后没生成 JS 或报错 “Unexpected indentation”

环境配好了，但一编译就出错？别急着怀疑配置，很多时候问题出在 CoffeeScript 语言本身的一个核心特性上：它对空白符（空格和缩进）极其敏感。Sublime 的默认缩进是 4 个空格，而 CoffeeScript 社区惯例是 2 个空格，并且严禁空格与 Tab 混用，缩进层级必须严格对齐。

• 首要任务是关闭 Sublime 的自动缩进检测。在编辑器设置（Preferences → Settings）里，添加一行："detect_indentation": false。
• 接着，强制统一为 2 空格缩进：设置 "tab_size": 2 和 "translate_tabs_to_spaces": true。
• 强烈建议开启视觉辅助：在 View → Indentation 菜单下，勾选 Show Indent Guide（显示缩进参考线）和 Show Whitespaces（显示空白字符）。这样能快速定位哪里混入了 Tab 或者空格没对齐。
• 如果报“Unexpected indentation”错误，注意看错误行号。它经常指向“上一行的末尾”，因为缩进断裂的逻辑起点其实是上一行。所以，重点检查 if、for、函数定义这些块级结构的起始行，确保它们后面的代码块缩进一致。

要不要装 CoffeeScript 的实时预览插件？

市面上有些插件，比如 SublimeOnSa veBuild 或 AutoFileName，号称能实现保存即编译。但对于 CoffeeScript 来说，这类自动化工具未必是好事，它们有时会掩盖掉编译过程中的缩进错误，让你找不到问题的根源。

• 更可靠的工作流是：专注于写出语法正确的 .coffee 代码，然后主动按 Ctrl+B 触发编译。仔细阅读终端里的错误信息，精准定位问题。
• 需要调试时，可以在编译命令中加入 -m 参数生成 Source Map，然后在浏览器的开发者工具中直接调试原始的 CoffeeScript 代码，这比依赖编辑器的模拟执行要靠谱得多。
• 如果项目确实需要自动化监听编译，更稳定的方案是使用 npm scripts：在 package.json 中配置一个 watch 命令，调用 coffee -cw。让专业的构建工具做专业的事，Sublime 则回归它最擅长的文本编辑角色。

说到底，语法高亮只是入门。CoffeeScript 那种靠缩进定义代码块、隐式返回值的特性，才是日常开发中最容易踩坑的地方。工具配置得再花哨，也解决不了少敲一个空格带来的语法错误。