VSCode 1.20.1无法在Node.js v8断点处暂停，求排查方案

我之前也碰到过Docker + VSCode调试断点死活不触发的糟心事，结合你简化后的3行代码项目，咱们一步步来排查和解决：

你用VSCode 1.20.1调试运行在node:8 Docker容器里的Node.js项目，使用Inspector协议时断点完全没反应，已经把代码简化成带延迟的Hello World来规避调试器附加的竞争问题，但还是没解决。

你的示例代码与配置 #

先把你提到的关键内容贴出来方便对照：

index.js（本地项目文件） #

setTimeout(() => {
  console.log('Hello World'); // 这里的断点始终不触发
}, 5000);

.vscode/launch.json（VSCode调试配置） #

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "node",
      "request": "attach",
      "name": "Attach to Docker Node",
      "port": 9229,
      "address": "localhost",
      "localRoot": "${workspaceFolder}",
      "remoteRoot": "/app",
      "protocol": "inspector"
    }
  ]
}

Docker启动命令（推测你用的类似命令） #

docker run -it --rm -p 9229:9229 -v $(pwd):/app node:8 node --inspect=0.0.0.0:9229 index.js

1. 路径映射完全不匹配（最容易踩的坑） #

VSCode调试器需要把本地代码和容器内运行的代码做路径关联，如果localRoot和remoteRoot对应不上，调试器根本找不到断点对应的代码位置：

• 确认${workspaceFolder}就是你本地项目的根目录（VSCode打开的文件夹要正确）。
• 容器内的remoteRoot必须和docker run里-v挂载的路径完全一致，比如你挂载的是/app，那remoteRoot就不能写成/usr/app。
• 可以进容器验证：执行docker exec -it <容器ID> ls /app，确保能看到index.js。

2. Inspector协议兼容性问题 #

VSCode 1.20.1算是比较老的版本，和Node.js 8的Inspector协议可能存在小兼容性问题：

• 把launch.json里的protocol改成auto，让VSCode自动匹配合适的协议：

  "protocol": "auto"
  

• 加上stopOnEntry: true，让调试器附加后立即暂停在代码开头，先验证连接是否正常：

  "stopOnEntry": true
  

3. Docker调试端口没正确暴露 #

如果容器内的调试器只绑定了127.0.0.1，本地根本连不上：

• 启动容器时必须加--inspect=0.0.0.0:9229，不能只写--inspect（默认绑定127.0.0.1）。
• 验证本地能访问端口：执行curl http://localhost:9229/json，如果返回类似调试器信息的JSON，说明端口映射没问题。

4. 调试器附加时机还是有竞争 #

虽然你加了5秒延迟，但有时候还是赶不上，试试用--inspect-brk强制Node在代码开头暂停，等调试器连接：

docker run -it --rm -p 9229:9229 -v $(pwd):/app node:8 node --inspect-brk=0.0.0.0:9229 index.js

启动容器后，再打开VSCode启动调试会话，这时候应该能直接停在代码第一行，再手动跳到console.log那行加断点，继续执行就能触发了。

1. 用--inspect-brk启动容器，此时终端会显示Debugger listening on ws://0.0.0.0:9229/xxxx的信息，说明已经暂停等待调试器。
2. 在VSCode里启动调试会话，应该能看到调试工具栏激活，代码停在setTimeout那一行。
3. 在console.log行打个断点，点击继续执行，5秒后断点就会触发了。

内容的提问来源于stack exchange，提问作者Manish