在VSCode中调试运行在Docker容器内的应用

答案：通过配置Docker容器暴露调试端口并映射路径，VSCode可远程调试容器内Node.js应用。具体步骤包括：在Dockerfile中使用--inspect=0.0.0.0:9229启动Node应用，通过docker-compose.yml映射9229端口，在VSCode的launch.json中配置attach模式，设置localRoot和remoteRoot路径一致，启动容器后在VSCode中连接调试，确保代码同步与端口通畅即可实现断点调试。

要在VSCode中调试运行在Docker容器内的应用，关键是将开发环境与容器打通，让调试器能连接到容器中的进程。以下是具体实现步骤，以Node.js应用为例，其他语言可类推。

配置Docker容器支持调试

确保你的应用在容器中启动时，能启用调试模式并暴露调试端口。

CMD ["node", "--inspect=0.0.0.0:9229", "app.js"]

在 docker-compose.yml 或运行命令中映射调试端口：

ports:
  - "9229:9229"

在VSCode中配置调试器

在项目根目录创建 .vscode/launch.json 文件：

面试猫

AI面试助手，在线面试神器，助你轻松拿Offer

39

查看详情

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

启动调试流程

按以下顺序操作：

• 构建并启动Docker容器（使用 docker-compose up 或 docker run）
• 确认容器内应用已启动且输出类似 “Debugger listening on ws://0.0.0.0:9229”
• 在VSCode中打开对应项目
• 切换到“运行和调试”侧边栏，选择“Attach to Node in Docker”并启动
• 连接成功后，即可在代码中设断点、查看变量、单步执行

常见问题处理

如果调试器连接失败，检查以下几点：

• 容器是否正确映射了 9229 端口
• node 启动时是否带 --inspect 参数且绑定 0.0.0.0
• launch.json 中的 remoteRoot 路径是否与容器内实际路径一致
• 本地文件修改后是否已同步进容器（建议使用卷挂载代码目录）

基本上就这些。只要端口通、路径对、调试模式开，VSCode就能顺利接入容器内进程。不复杂但容易忽略细节。

以上就是在VSCode中调试运行在Docker容器内的应用的详细内容，更多请关注php中文网其它相关文章！