VSCode运行Node.js调试中断与进程附加教程-VSCode-PHP中文网

VSCode调试Node.js断点不触发主因是调试模式不匹配：attach需目标进程已启用--inspect，否则无法连接；端口、路径映射、sourceMap等任一环节错位均导致断点灰色。

vscode运行node.js调试中断与进程附加教程

VSCode 调试 Node.js 时“断点不触发”或“附加失败”，90% 不是环境坏了，而是调试模式没对上——你用 attach 方式去连一个根本没开 --inspect 的进程，就像拿钥匙捅一扇没锁的门。

VSCode 的 attach 配置不会让进程“变可调试”，它只负责连接已暴露调试协议的进程。

Could not connect to debug target：目标进程启动时没加 --inspect 或 --inspect-brk，或者端口被占用/绑定在 127.0.0.1（容器/远程场景常见）
进程列表里看不到目标：用 ps aux | grep -- --inspect 确认命令行是否真含该参数；Docker 容器内需检查是否挂载了 --inspect 到 node 启动命令中
连上了但断点灰色：路径映射错位，比如你在 /Users/me/project 打开 VSCode，而进程加载的是 /app/src 下的代码，必须配 pathMapping 或 webRoot
Process with specified id does not exist：手动填了 processId 却输错，建议留空让 VSCode 弹框选择

不同语言、不同部署方式下字段含义差异极大，硬套模板必报错。

type 必须为 "node"（不是 "pwa-node"，后者在某些旧扩展或 TS 场景下行为不一致）
request 必须为 "attach"（"launch" 是 VSCode 自己起进程，和“附加”无关）
port 必须和启动命令中的端口严格一致，例如 node --inspect=9230 app.js → "port": 9230
address 默认 "localhost"，但在 Docker 容器中要改成 "host.docker.internal"（macOS/Windows）或容器网关 IP（Linux）
远程服务器调试必须配 remoteRoot 和 localRoot，且都得是绝对路径，例如："remoteRoot": "/home/deploy/app", "localRoot": "${workspaceFolder}"

autoAttachChildProcesses 只在 request: "launch" 下生效，对 attach 模式完全无效——这是最常被文档误导的地方。

logos-node

在 Linux x86_64 上安装、更新或检查 Logos 区块链测试网验证节点。用于用户需要搭建 Logos 节点时使用。

下载

子进程本身必须显式启用调试：用 fork() 时传 { execArgv: ['--inspect-brk=9231'] }；用 spawn() 时把 --inspect-brk 加进 args 数组
多个子进程不能共用同一端口，否则只有第一个能连上；推荐去掉端口号，写成 --inspect-brk 让 Node 自动分配
npm script / nodemon / ts-node 启动的进程会绕过标准 Node 启动流程，autoAttachChildProcesses 失效，应改用原生 node --inspect-brk 启动主进程
如果只是临时查问题，更简单的方式是：在子进程代码开头加 debugger，再用 node --inspect-brk 启动，VSCode 会自动停住

全局开启 Debug: Toggle Auto Attach 后，VSCode 会在后台监听所有带 --inspect 的 Node 进程，但它不处理路径映射、sourceMap 或跨容器通信。

必须用 node --inspect-brk 启动（不是 npm start，除非脚本里写了该参数）
端口冲突时，VSCode 默认只监听 9229；要支持其他端口，需在设置里打开 debug.javascript.autoAttachPortRange 并填范围，如 [9229, 9235]
误附加到 node_modules 里的工具进程？加 debug.javascript.autoAttachExclusions 排除路径，例如 ["**/node_modules/**"]
在 WSL 或远程 SSH 环境中，Auto Attach 默认不工作，因为进程元数据无法跨系统传递；此时只能退回 attach 模式 + 显式端口配置