VSCode不能直接运行.coffee文件，必须依赖coffee命令行工具；需全局安装coffeescript@2（而非@3），配置code-runner的executorMap键名为"coffeescript"而非"coffee"，并确保语言模式为CoffeeScript而非JavaScript。
VSCode 不能直接运行 .coffee 文件，必须靠 coffee 命令行工具驱动；老项目用 CoffeeScript 2.x 或更早版本时，全局装 coffeescript@2 仍是唯一稳定路径。
coffee 命令不识别：PATH 和 Node 版本错位
VS Code 内置终端打 coffee --version 报 command not found，不是没装，而是 shell 环境和 VS Code 启动时读取的 PATH 不一致。尤其在 macOS/Linux 用 nvm/fnm 管理 Node 时，VS Code 常加载不到 shell 配置里的 bin 路径。
- 验证方式：在 VS Code 内置终端执行
which coffee；若为空，说明它根本找不到命令 - 临时解法：在终端里先
nvm use 16（或你项目对应的 Node 版），再启动 VS Code：code . - 长期解法：把 nvm 初始化脚本加到
~/.zshrc（或~/.bash_profile）末尾，并确保 VS Code 是从该 shell 启动的 - 最省事兜底方案：改用
npx coffeescript@2替代coffee，避免全局安装依赖环境
code-runner 执行失败：executorMap 键名必须是 "coffeescript"
很多人配了 "coffee": "coffee $fullFileName" 却无效——VS Code 的 code-runner 插件识别的是语言 ID，不是文件后缀。.coffee 文件的语言 ID 是 coffeescript，不是 coffee。
- 打开
settings.json，找到code-runner.executorMap，添加这一行： -
"coffeescript": "npx coffeescript@2 -p $fileName"（-p 表示只打印编译结果，适合调试） - 如需直接运行，去掉
-p，但确保coffee能正确执行 Node 入口逻辑 - 务必检查右下角状态栏显示的是
CoffeeScript，不是JavaScript；点它手动切换
老语法报错：CoffeeScript 3 默认禁用旧特性
用 CoffeeScript 2.x 写的老代码（比如无括号函数调用、隐式 return、旧 class 语法），在 coffeescript@3 下会直接报 Unexpected token——这不是 VS Code 的错，是编译器本身拒绝解析。
- 不要升级到 coffeescript@3，除非你已重写全部语法；
npm install -g coffeescript@2.7.0是兼容性最稳的选择 - 若必须用新版本，可在
coffee命令后加--compat参数（仅部分支持，不保证全覆盖） - VS Code 里看到红波浪线但实际能跑？说明语言模式是
JavaScript，它在用 JS 解析器校验 CoffeeScript 代码——点击右下角切回CoffeeScript
保存即编译 JS：tasks.json 比插件更可控
依赖 “自动编译” 插件容易失灵，尤其老项目结构杂乱时。用 VS Code 原生 tasks.json 驱动 coffee -c 更可靠，且可精确控制输出路径和 source map。
- 在
.vscode/tasks.json中写： -
"command": "npx coffeescript@2", "args": ["-c", "-m", "${file}"]（-m生成 source map） - 设
"isBackground": true和"problemMatcher": ["$coffee"]，让错误实时浮现 - 绑定到保存事件：在
settings.json加"files.autoSave": "onFocusChange"+ 手动触发任务，比“保存即编译”插件少一层抽象
老 CoffeeScript 项目最常卡在「命令存在但 VS Code 找不到」和「语法能跑但编辑器报错」这两点；绕过它们的关键不是换工具，而是明确每一步谁在干活：插件只管高亮，coffee 负责编译，VS Code 只负责把两者连起来——连错了，就全断。
