多进程调试需让每个进程暴露调试接口并用VSCode连接。通过配置--inspect端口或使用autoAttachChildProcesses实现主子进程断点调试，避免端口冲突即可顺畅调试。
调试多进程应用在VSCode中确实比单进程复杂，但通过合理配置，可以实现主进程与子进程的无缝断点调试。关键在于理解进程启动机制，并利用VSCode的动态附加（attach）能力。
理解多进程调试的核心挑战
当应用使用fork、spawn或cluster创建子进程时，这些新进程不会自动继承父进程的调试器。默认情况下，VSCode只能调试启动命令直接对应的进程，子进程处于“无调试”状态。
常见表现是：主进程断点生效，子进程代码跳过断点直接执行。解决思路是让VSCode能“找到并连接”每一个需要调试的进程。
方案一：启动时统一开启调试参数
适用于可预知子进程数量和启动方式的场景。通过环境变量或命令行参数，让所有进程以调试模式启动。
- Node.js应用可在启动时添加
--inspect=9229或--inspect-brk=9229 - 若主进程启动5个子进程，可让它们依次使用9230~9234端口避免冲突
- 示例命令：
"command": "node --inspect=9229 app.js"
子进程中需读取环境变量或传参决定inspect端口，例如：
const port = 9229 + process.env.WORKER_ID;
require('inspector').open(port);
方案二：动态附加到新进程（推荐）
更灵活的方式是先运行应用，再用VSCode的Attach功能连接已运行的进程。适合无法预设端口或进程动态创建的场景。
- 在
launch.json中配置多个attach项，分别对应不同端口 - 使用
processId字段直接附加到指定PID（需先用ps或lsof查进程） - 借助
autoAttachChildProcesses选项（Node.js调试器支持）自动捕获子进程
示例配置：
{
"name": "Attach to Parent",
"type": "node",
"request": "attach",
"port": 9229,
"autoAttachChildProcesses": true
}
实用技巧与避坑指南
多进程调试容易因端口冲突或时机问题失败。以下几点能提升成功率：
- 使用
--inspect-brk让进程启动时暂停，确保有足够时间附加 - 为不同角色进程命名（如master/worker），便于区分调试会话
- 结合
console.log输出inspect URL，快速定位可用端口 - 关闭其他占用9229端口的应用，避免
EADDRINUSE错误
基本上就这些。掌握端口管理与自动附加机制，多进程调试就能像单进程一样顺畅。关键是让每个进程暴露调试接口，并让VSCode知道如何连上它。
