coffee命令不被VS Code识别是因为其依赖Node.js全局安装，需先在系统终端验证coffee --version；Code Runner需手动配置coffeescript语言ID的executorMap；调试须设runtimeExecutable为"coffee"并确保sourceMaps启用。

coffee 命令不被 VS Code 识别？先确认它真能跑起来

VS Code 本身不带 CoffeeScript 解释器，coffee 是独立 CLI 工具，必须由 Node.js 环境提供。如果右键“Run Code”报 command not found: coffee，不是插件没装，而是终端根本找不到这个命令。

• 在系统终端（非 VS Code 内置终端）执行 coffee --version，有输出才说明安装成功
• 全局安装用 npm install -g coffeescript（注意不是 coffee-script，旧包已废弃）
• macOS/Linux 用户若用 nvm/fnm 管理 Node，VS Code 可能未加载 shell 的 PATH，此时改用 npx coffee $fullFileName 更稳
• Windows 用户常见问题是 npm 全局 bin 路径未加入系统环境变量，重装 Node 或手动添加 %APPDATA%\npm 到 PATH

Code Runner 怎么配才能一键运行 .coffee 文件

默认情况下，Code Runner 对 .coffee 文件完全无响应——它压根没注册该语言的执行器。必须手动补全 executorMap，且键名要匹配 VS Code 当前识别的语言 ID。

• 打开 settings.json，找到 code-runner.executorMap，添加条目："coffeescript": "coffee $fullFileName"
• 注意键名是 coffeescript（不是 coffee 或 coffeescipt），这是 VS Code 内置语言 ID
• 确保启用了 code-runner.runInTerminal 和 code-runner.saveFileBeforeRun，否则修改不生效
• 如果只想看编译结果不执行，用 "coffeescript": "coffee -p $fullFileName"，-p 表示打印 JS 输出

保存就编译成 .js？用 watch 比 tasks.json 更轻量

靠 tasks.json 配构建任务太重，CoffeeScript 自带 --watch，一行命令就能监听 + 编译，适合多数场景。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

• 终端运行 coffee -o lib/ -cw src/：监控 src/ 下所有 .coffee，输出到 lib/，保存即编译
• -c 是 compile，-w 是 watch，-o 指定输出目录，三者缺一不可
• 不要把 coffee -cw 塞进 tasks.json 的 isBackground: true 里——它会卡住任务，VS Code 无法正确终止进程
• 想开机自启？用 npm run dev 包一层，或直接加到 package.json 的 scripts 中："dev": "coffee -o lib/ -cw src/"

调试时断点不命中？sourcemap 路径和 runtimeExecutable 是关键

在 .coffee 文件打的断点不生效，通常不是代码问题，而是 launch.json 里 runtimeExecutable 指向错误，或 outFiles 路径没对上编译产物。

• runtimeExecutable 必须设为 "coffee"（不是 "node"），否则调试器根本不用 CoffeeScript 编译器
• program 字段填的是 .coffee 源文件路径，不是生成的 .js
• outFiles 要精确匹配实际生成的 JS 路径，比如 "${workspaceFolder}/lib/**/*.js"，不能写 "*.js"
• 务必开启 sourceMaps: true，且确保 coffee -c 编译时加了 --source-map（-cw 默认启用）

真正卡住人的地方，往往不是配置漏了哪一项，而是 VS Code 语言模式显示为 CoffeeScript，但背后没连上任何执行链路——它只是高亮，不编译、不运行、不调试。每一步都得验证终端命令是否真实可用，再串进编辑器，跳过这步，后面全在猜。