正确配置Docker和VS Code调试Node.js应用需四步：1. Dockerfile中使用--inspect=0.0.0.0:9229启动Node；2. docker-compose.yml映射9229端口；3. launch.json设置attach模式，匹配localRoot与remoteRoot路径；4. 启动容器后在VS Code中连接调试，确保端口开放与路径一致即可。
在 VS Code 中调试运行在 Docker 容器中的 Node.js 应用，关键在于正确配置容器的启动参数和 VS Code 的调试设置。只要确保 Node.js 进程以调试模式运行，并允许远程连接，就能顺利接入调试器。
1. 修改 Dockerfile 支持调试
确保你的 Dockerfile 使用支持调试的 Node.js 启动命令。通常使用 --inspect 或 --inspect-brk 参数。
示例：
CMD ["node", "--inspect=0.0.0.0:9229", "app.js"]
其中 --inspect=0.0.0.0:9229 表示监听所有网络接口的 9229 端口，允许外部调试器连接。使用 --inspect-brk 可让程序在第一行暂停，便于调试器附加。
2. 配置 docker-compose.yml 暴露调试端口
如果你使用 docker-compose，需要将调试端口映射到主机。
示例 docker-compose.yml：
- services:
- app:
- build: .
- ports:
- - "3000:3000"
- - "9229:9229"
这样主机就可以通过 localhost:9229 连接到容器内的调试器。
3. 配置 VS Code 的 launch.json
在项目根目录下的 .vscode/launch.json 中添加一个 Attach 配置：
- {
- "type": "node",
- "request": "attach",
- "name": "Attach to Docker",
- "address": "localhost",
- "port": 9229,
- "localRoot": "${workspaceFolder}",
- "remoteRoot": "/app"
- }
注意：remoteRoot 要与容器内应用路径一致（比如 Dockerfile 中 WORKDIR /app）。
4. 启动容器并连接调试
步骤如下：
- 运行
docker-compose up启动容器 - 确认日志中出现类似
Debugger listening on ws://0.0.0.0:9229/... - 在 VS Code 中选择 “Attach to Docker” 并启动调试
- 设置断点，查看变量，正常调试
基本上就这些。只要端口通、路径对、Node 启动参数正确，VS Code 就能顺利连接容器内进程。调试时常见问题多出在端口未暴露或路径映射不一致，检查这两点基本都能解决。
