Sublime Text配置CoffeeScript环境_Sublime Text前端脚本高亮设置【脚本】

Sublime Text 默认压根不认识 .coffee 文件。装错插件、缩进设错、路径没写对——这三个里面只要有一个出问题，你看到的就只是一片黑底白字的纯文本。不是高亮没生效，是编辑器根本没把这份文件当成 CoffeeScript 来解析。

必须装 Language CoffeeScript，不是 CoffeeScript 插件

很多人搜“CoffeeScript 插件”时随手点了搜索结果里的第一个，结果装的是早就废弃的 CoffeeScript 或 SublimeCoffeeScript。这两个包用的是老旧的 .tmLanguage 语法定义，在 Sublime Text 3/4 上直接失效。你会看到右下角状态栏永远显示 Plain Text，关键词全是黑色，缩进也没有分层效果。

• 正确做法：按 Ctrl+Shift+P → 输入 Install Package → 等列表加载完毕 → 搜索并安装 Language CoffeeScript（作者 jashkenas，官方维护）。
• 装完后打开任意 .coffee 文件，右下角状态栏必须显示 CoffeeScript；如果仍然是 Plain Text，说明插件没生效。
• 检查 Packages/User/ 下有没有残留的旧插件目录（比如 CoffeeScript/），有就直接删掉。
• 别手动把 CoffeeScript.tmLanguage 文件丢进 Packages——Sublime Text 3/4 已经弃用这个格式，会和 Language CoffeeScript 产生冲突。

右下角显示 CoffeeScript ≠ 缩进和高亮真正常

CoffeeScript 对空白符敏感到了极致。Sublime 一旦混用 Tab 和空格，或者缩进宽度不是 2，语法解析器就会放弃渲染：关键词变黑、缩进颜色消失、甚至右下角自动跳回 Plain Text。

• 菜单 → View → Indentation → Convert Indentation to Spaces。
• 再点 Indentation → Tab Width: 2。
• 在 Preferences → Settings（用户设置）里加一行："detect_indentation": false，防止编辑器自作主张重设缩进。
• 改完设置后，已打开的 .coffee 文件需要关闭再重开，或者按 Ctrl+Shift+P → 输入 Reload Syntax 回车。

构建系统里 coffee 命令找不到，跟终端能跑是两码事

你在终端里敲 coffee --version 能成功，不代表 Sublime 也能调用到它。Sublime 的构建系统启动时读的是自己的环境变量，不会继承 shell 的 PATH。

• 先查真实路径：
  Windows：在 CMD 里运行 where coffee，结果类似 C:\Users\xxx\AppData\Roaming\npm\coffee.cmd
  macOS/Linux：终端运行 which coffee，结果类似 /usr/local/bin/coffee
• 在 Sublime 控制台（Ctrl+`）运行 import os; print(os.environ.get('PATH'))，确认输出里包含上面查到的路径。
• 新建构建系统（Tools → Build System → New Build System…），内容如下：
  Windows：

  { "cmd": ["coffee.cmd", "-c", "$file"], "selector": "source.coffee", "path": "C:\Users\xxx\AppData\Roaming\npm" }

  macOS/Linux：

  { "cmd": ["coffee", "-c", "$file"], "selector": "source.coffee", "path": "/usr/local/bin:/opt/homebrew/bin" }

• 注意：cmd 字段在 Windows 上必须写成 coffee.cmd，不能只写 coffee；path 必须是绝对路径，且不含引号。

最容易被忽略的一点：就算所有配置都对，新建一个 .coffee 文件时，Sublime 仍然默认用 Plain Text 语法——你得手动点右下角切换一次，或者按 Ctrl+Shift+P → Set Syntax: CoffeeScript。这不是 Bug，是 Sublime 的默认行为，它不会帮你记住上一次用的是哪个语法。