Node.js基于sourcemap调试编译为JS的非JS语言问题排查

• 执行node inspect temp.coffee时，Node.js默认将.coffee后缀文件作为原生JavaScript解析，不会自动调用CoffeeScript编译器转译，也不会主动加载你提前生成的sourcemap文件。
• 终端输出的"调试器已附着"只是调试进程初始化的固定提示，此时目标执行进程已经因为无法识别CoffeeScript语法触发语法错误，直接运行退出，根本没有进入断点暂停状态，因此输入单步、运行、重启命令都会抛出Can only perform operation while paused错误。
• 注意：Node.js inspect默认的"首条语句前暂停"逻辑，仅在目标入口文件可被正常解析为合法JavaScript时才会生效，无法解析的文件不会触发暂停流程。

方案1：预编译调试（兼容性最好，适配所有Node.js LTS版本） #

1. 原有编译命令保持不变：

   coffee -cm temp.coffee
   

   执行后确认同目录生成temp.js、temp.js.map两个文件，且temp.js文件末尾存在//# sourceMappingURL=temp.js.map的注释行。
2. 调试入口改为编译生成的JS文件，不要直接传入CoffeeScript源文件：

   node inspect temp.js
   

3. 进入调试交互界面后，Node.js会自动读取关联的sourcemap，映射到原始CoffeeScript源码，支持直接在CoffeeScript代码行设置断点、单步执行、查看变量值，你预先写在源码里的debugger语句也会正常命中，所有源码和编译后代码的行号转换由Node.js内置能力自动完成。

方案2：自动转译调试（无需手动编译，适合快速迭代场景） #

如果不想每次修改源码后都手动执行编译，可以借助CoffeeScript的require钩子实现运行时自动转译：

1. 本地项目安装CoffeeScript依赖：

   npm install coffeescript
   

2. 启动调试时提前加载CoffeeScript注册器，再传入源文件路径：

   node inspect --require coffeescript/register temp.coffee
   

3. 该模式下Node.js会在执行过程中实时转译CoffeeScript代码，自动生成内联sourcemap，无需提前生成JS和map文件，同样支持直接在CoffeeScript源码层面完成所有调试操作。

• 若使用方案1调试时加载的仍是JS代码而非CoffeeScript源码，先检查编译时是否添加了-m参数生成sourcemap，再确认JS文件末尾的sourceMappingURL注释未被构建工具或手动修改删除。
• 预编译生成的JS、map文件和CoffeeScript源文件不要随意改动相对路径，sourcemap中记录的源文件路径是编译时生成的，相对位置变化会导致源码映射失效。

内容的提问来源于stack exchange，提问作者John Deighan