VSCode调试Node.js断点不触发主因是调试模式不匹配：attach需目标进程已启用--inspect，否则无法连接；端口、路径映射、sourceMap等任一环节错位均导致断点灰色。
VSCode 调试 Node.js 时“断点不触发”或“附加失败”，90% 不是环境坏了，而是调试模式没对上——你用 attach 方式去连一个根本没开 --inspect 的进程，就像拿钥匙捅一扇没锁的门。
为什么 attach 模式连不上正在运行的 Node.js 进程
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 弹框选择
launch.json 中 attach 配置的关键字段怎么填
不同语言、不同部署方式下字段含义差异极大，硬套模板必报错。
-
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 不是万能开关
autoAttachChildProcesses 只在 request: "launch" 下生效，对 attach 模式完全无效——这是最常被文档误导的地方。
- 子进程本身必须显式启用调试：用
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 会自动停住
自动附加（Auto Attach）比手动 attach 更快，但有隐藏依赖
全局开启 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模式 + 显式端口配置
复杂点从来不在“怎么点按钮”，而在谁在什么时候暴露了什么端口、路径是否真实对应、sourceMap 是否随产物一起部署到了运行环境。漏掉其中任意一环，VSCode 都只会安静地显示一个空心断点。
