Node.js多线程调试必须启用autoAttachChildProcesses:true，而非仅开多个终端；它使VS Code自动附加fork子进程和Worker Threads，但需配合--inspect-brk、唯一端口及正确sourceMap配置。
Node.js 多线程调试依赖 autoAttachChildProcesses，不是靠“启动多个终端”
VS Code 里开多个集成终端并行跑 node worker.js 和 node main.js，不等于实现了多线程调试——这只是多个独立进程，断点互不感知、调用栈不联动、变量无法跨上下文查看。真正支持 Worker Threads 或 child_process.fork() 的调试，必须启用调试器的子进程自动附加机制。
关键配置在 .vscode/launch.json 中："autoAttachChildProcesses": true 是开关，不是可选项。它让 vscode-js-debug 在父进程启动时监听所有新创建的子进程，并自动建立调试会话。
- 仅对
child_process.fork()和Worker构造函数生效；spawn()需额外加--inspect参数才被识别 - 若项目用了
ts-node或esbuild-node启动，autoAttachChildProcesses会失效——因为它们不走标准 Node.js 启动流程 - macOS/Linux 下，如果用 nvm 管理 Node 版本，必须在
launch.json中显式写"runtimeExecutable"，否则子进程可能用错版本
Worker 调试必须配 --inspect-brk，否则断点不命中
Node.js 的 Worker 默认不开启调试端口，即使启用了 autoAttachChildProcesses，也会因端口未暴露而跳过附加。正确做法是在启动 Worker 时传入调试参数：
new Worker('./worker.js', {
execArgv: ['--inspect-brk=9229']
});
同时确保 launch.json 中对应配置包含：
-
"runtimeArgs": ["--inspect-brk"]（用于主进程监听） "autoAttachChildProcesses": true-
"port": 9229（与execArgv中端口一致，避免冲突）
注意：端口号不能被其他进程占用，且不同 Worker 实例若共用同一端口，会导致调试器只连上第一个——建议每个 Worker 使用唯一端口，或直接依赖自动分配（不指定端口，让 Node 自选）。
child_process.fork() 子进程调试失败，大概率是没传 execArgv
用 fork() 创建子进程时，如果不显式传递调试参数，子进程完全不知道自己该被调试。常见错误写法：
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
fork('./sub.js'); // ❌ 无调试能力
正确写法必须带 execArgv：
fork('./sub.js', [], {
execArgv: ['--inspect=9230']
}); // ✅ 指定调试端口
此时 VS Code 才能通过 autoAttachChildProcesses 发现并连接它。但要注意：
- 端口不能和主进程冲突（主进程默认用 9229，子进程建议从 9230 起递增）
- 如果子进程是 TypeScript 文件，需确保
ts-node已全局安装，且execArgv中加入--loader ts-node/esm - Windows 下路径分隔符错误（如硬编码
'./sub.js'在 Windows 可能解析失败），建议统一用path.join(__dirname, 'sub.js')
调试时看到空心断点？检查源码路径映射是否匹配
断点显示为空心圆（未绑定），不是代码问题，而是调试器找不到对应源文件。VS Code 调试器根据 sourceMap 或运行时路径匹配断点位置，常见原因有：
- Worker 或子进程工作目录（
cwd）和主进程不一致，导致相对路径解析失败 - 使用打包工具（如 esbuild、webpack）后，生成的
.js和.map文件路径与实际运行路径不符 - TS 编译输出到
dist/，但断点打在src/，且sourceRoot字段未正确指向源码目录
验证方法：在 Worker 或子进程代码开头加 console.log(__filename)，看输出路径是否和你在编辑器里打开的文件路径一致。不一致就需在 launch.json 中加 "sourceMaps": true 和 "outFiles" 显式声明输出路径。
多线程调试真正的复杂点不在配置本身，而在路径、版本、启动方式三者耦合——改一行 execArgv 可能触发 nvm 切换失效，删一个 sourceMap 配置会让断点全丢。动手前先确认当前 Node 版本、启动命令、源码结构这三项是否稳定一致。
