在VS Code中调试在Docker容器中运行的Node.js应用

正确配置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 就能顺利连接容器内进程。调试时常见问题多出在端口未暴露或路径映射不一致，检查这两点基本都能解决。