CoffeeScript需手动配置才能在VS Code中运行、编译和调试：先全局安装coffeescript并确保coffee命令可用，再通过Code Runner插件配置npx coffee执行；用tasks.json实现保存自动编译并生成source map；调试时launch.json必须设runtimeExecutable为"coffee"、program为.coffee文件、outFiles匹配JS路径且sourceMaps为true。
coffee 命令不是 VS Code 内置功能，必须显式配置才能运行 `.coffee` 文件。直接右键“Run Code”或按 Ctrl+Alt+N 会失败——这不是插件没装对，而是 VS Code 从不原生支持 CoffeeScript 执行。
确认 coffee 命令可用，且路径被 VS Code 终端识别
VS Code 的集成终端可能无法加载 shell 初始化后的 PATH（尤其 macOS/Linux），导致 coffee --version 在终端里报 command not found，即使你在系统终端能正常运行。
- 先在系统终端执行
npm install -g coffeescript（注意包名是coffeescript，不是coffee-script） - 验证：
coffee --version应输出类似3.0.1的版本号 - 若 VS Code 终端仍找不到
coffee，改用npx coffee：它不依赖全局 PATH，更可靠 - Windows 用户若用 PowerShell，需确认执行策略允许脚本：
Get-ExecutionPolicy若为Restricted，临时设为RemoteSigned
配置 Code Runner 插件执行 .coffee 文件
Code Runner 默认不认 coffeescript 类型，必须手动补全 executorMap。否则点击运行只会静默退出或报错 Cannot find runner for file。
- 打开设置 → 搜索
code-runner.executorMap→ 点击「在 settings.json 中编辑」 - 在已有 JSON 对象的
executorMap里添加："coffeescript": "npx coffee $fullFileName" - 确保已启用
code-runner.runInTerminal和code-runner.saveFileBeforeRun - 文件右下角语言模式必须是
CoffeeScript（点击切换，或按Ctrl+K Ctrl+M输入coffeescript）
保存即编译：用 tasks.json 自动生成 .js
仅靠运行不够，开发中常需生成对应 JS 文件用于调试或部署。VS Code 内置任务系统比第三方插件更稳定，且天然支持 source map。
- 项目根目录建
.vscode/tasks.json，内容如下：
{
"version": "2.0.0",
"tasks": [
{
"label": "compile-coffee",
"type": "shell",
"command": "coffee -c -m ${file}",
"group": "build",
"presentation": { "echo": false, "reveal": false },
"problemMatcher": ["$coffeescript"]
}
]
}
-
-m参数生成 source map，调试时断点才落在 .coffee 源码上 - 配合
files.associations确保识别："*.coffee": "coffeescript" - 按
Ctrl+Shift+B选该任务，或设为保存时自动触发（需额外扩展如Auto Run Task）
调试 CoffeeScript：launch.json 关键字段不能漏
断点打在 .coffee 上却停不住？常见原因是 sourceMaps 开了但 outFiles 路径不匹配，或 runtimeExecutable 指向错误。
-
runtimeExecutable必须设为"coffee"（不是"node"），否则调试器根本不会调用 CoffeeScript 编译器 -
program字段填的是 .coffee 路径，不是 .js —— 这是 CoffeeScript 调试和普通 Node.js 调试的根本区别 -
outFiles要精确匹配生成的 JS 路径，例如："${workspaceFolder}/dist/**/*.js"；若用-c编译到同目录，可写"${fileDirname}/*.js" - 确保
sourceMaps为true，且 .coffee 文件编译时加了-m或--map
coffee 命令、source map 生成、VS Code 的 launch 配置、文件路径三者必须严丝合缝。少一个 -m，断点就失效；outFiles 多一级 **，也可能找不到映射。别跳过验证步骤。 
