配置VSCode以调试在Docker容器中运行的应用程序-VSCode-PHP中文网

配置VSCode以调试在Docker容器中运行的应用程序

betcha

发布： 2025-11-06 21:48:03

原创

662人浏览过

答案：通过配置应用远程调试、Docker暴露调试端口及VSCode的launch.json，可实现容器内应用调试。具体包括：1. 应用启用调试并绑定0.0.0.0；2. Dockerfile和docker-compose.yml安装调试工具并映射端口；3. VSCode配置attach模式连接容器进程。

配置vscode以调试在docker容器中运行的应用程序

要在 VSCode 中调试运行在 Docker 容器中的应用程序，关键是正确配置开发环境，使调试器能连接到容器内的进程。以下是实现这一目标的清晰步骤。

1. 确保应用支持远程调试

不同语言的应用需要不同的调试工具支持：

• Node.js：使用内置的 inspector，启动时加上 --inspect=0.0.0.0:9229

• Python（使用 debugpy）：安装 debugpy 并在代码中插入监听逻辑，例如：
import debugpy; debugpy.listen(('0.0.0.0', 5678))

• .NET：使用 vsdbg 或 dotnet-dbg，确保端口映射正确

• Go：集成 Delve（dlv），以 dlv --listen=:2345 --headless=true --api-version=2 启动

确保调试服务绑定到 0.0.0.0 而非 localhost，以便容器外部可访问。

2. 修改 Dockerfile 和 docker-compose.yml

在构建镜像时包含调试工具，并暴露调试端口：

• 在 Dockerfile 中安装调试依赖，如 debugpy 或 delve• 使用 EXPOSE 声明调试端口（如 9229、5678、2345）• 在 docker-compose.yml 中映射调试端口：

services:
  app:
    build: .
    ports:
      - "3000:3000"
      - "9229:9229"  # Node.js 调试端口
    environment:
      - NODE_OPTIONS=--inspect=0.0.0.0:9229

登录后复制

对于 Python 示例，启动命令应包括运行 debugpy：

command: python -m debugpy --listen 0.0.0.0:5678 app.py

登录后复制

3. 配置 VSCode 的 launch.json

在项目根目录的 .vscode/launch.json 中添加对应语言的远程调试配置：

面试猫

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

查看详情

• Node.js 示例：

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

登录后复制

• Python 示例（需安装 Python 扩展）：

{
  "name": "Python: Remote Attach",
  "type": "python",
  "request": "attach",
  "connect": {
    "host": "localhost",
    "port": 5678
  },
  "pathMappings": [
    {
      "localRoot": "${workspaceFolder}",
      "remoteRoot": "/app"
    }
  ]
}

登录后复制

确保 remoteRoot 与容器内应用路径一致，通常为 /app 或 /usr/src/app。