VSCode怎么配置Node.js使用Nodemon实现修改后端代码后调试器自动重新启动

VSCode通过attach模式配合nodemon实现热重载调试：先运行npm run debug（含--inspect-brk），再在launch.json中配置"request": "attach"、"port": 9229和"restart": true，确保调试器自动重连新进程。

想让VSCode在代码保存后自动重启调试会话？其实，VSCode本身并不直接负责重启进程，但我们可以借助nodemon来实现这个效果。关键在于理解其工作原理：不是“VSCode重启了进程”，而是“VSCode主动连接上了nodemon重启后的新进程”。

用 attach 模式连接 nodemon 启动的进程

这是目前最稳定、兼容性也最好的方案。它的核心思路是让VSCode只做一件事：监听并连接到一个已经存在的调试端口。这样一来，就完全避开了VSCode在不同操作系统下直接启动nodemon可能遇到的各种路径问题。

具体操作，可以遵循下面这个流程：

• 首先，nodemon启动时必须带上--inspect或--inspect-brk参数，这是打开调试端口的前提。
• 在package.json里配置一个调试脚本，例如："debug": "nodemon --inspect-brk ./index.js"（请根据你的实际入口文件调整路径）。
• 接下来，先在终端运行npm run debug。当你看到终端输出类似“Debugger listening on ws://127.0.0.1:9229/...”的信息时，就说明调试端口已经就绪了。
• 最后，在.vscode/launch.json中添加一个attach类型的配置。需要关注的几个关键字段是："request": "attach"、"protocol": "inspector"以及至关重要的"restart": true。
• 关于进程ID，使用"processId": "${command:PickProcess}"手动选择是一种方式，但更推荐直接固定端口，比如配置"port": 9229。这样可以省去每次手动选择进程的麻烦，实现自动连接。

launch 模式下用 runtimeExecutable 的坑

很多开发者一开始会尝试让VSCode的launch模式直接去执行nodemon，但这往往会导致一些意想不到的问题。比如在Windows上可能会报spawn nodemon ENOENT错误，而在macOS或Linux上，VSCode也可能找不到项目本地node_modules/.bin/目录下的nodemon。

问题出在哪里呢？

• 首先，runtimeExecutable的值不能简单地写成"nodemon"。因为VSCode默认会去系统的PATH环境变量里查找，而不会主动去识别项目本地的node_modules。
• 那么，写成绝对路径"${workspaceFolder}/node_modules/.bin/nodemon"总行了吧？理论上可行，但在Windows系统下，由于脚本扩展名（可能是.cmd）的问题，这个路径仍然可能失效。
• 一个更稳妥的变通方法是，将runtimeExecutable设置为"npm"，然后通过runtimeArgs参数来调用我们定义好的脚本，例如："runtimeArgs": ["run", "debug"]。
• 采用这种方式，你必须确保package.json中的debug脚本已经明确包含了--inspect参数，否则调试端口依然无法打开。

为什么 --inspect-brk 比 --inspect 更适合调试

在参数选择上，--inspect-brk通常比单纯的--inspect更受调试者青睐。原因很简单：-brk这个参数会让Node.js进程在执行第一行代码前就自动暂停。

这个“暂停”非常关键。它确保了你可以在任何初始化逻辑（比如Express中间件的加载、数据库连接的建立）执行之前，就有充足的时间来设置好断点。如果没有这个暂停，你可能会发现，断点虽然设在了require之后、app.listen()之前，但代码“嗖”一下就过去了，根本停不下来。

• 本质上，--inspect-brk相当于在代码开头插入了一个debugger语句。VSCode的调试器附加成功后，会自动继续执行，之后你就可以在任何需要的地方自由设置新的断点了。
• 值得注意的是，如果你使用的是上面推荐的attach模式并固定了端口，那么对于VSCode来说，连接--inspect-brk启动的进程和连接--inspect启动的进程，在行为上没有区别。但这个参数对于开发者肉眼确认“调试进程已准备就绪”的状态，非常有帮助。

最后，还有一个极其容易忽略的细节：VSCode配置中restart: true这个选项，其生效的前提是调试器已经成功附加（attach）到了目标进程。而能否附加成功，又完全取决于nodemon是否已经启动并打开了调试端口。

所以，正确的操作顺序必须是：先在终端运行npm run debug，然后再点击VSCode的绿色调试启动按钮。如果顺序反了，调试器就会一直卡在“等待连接”的状态，无法正常工作。记住这个顺序，问题就解决了一大半。