VS Code远程容器开发：Docker环境配置与调试方案-VSCode-PHP中文网

VS Code远程容器开发：Docker环境配置与调试方案

夜晨

发布： 2025-11-03 12:51:02

原创

812人浏览过

使用 VS Code 远程容器开发可实现统一环境，核心是配置 .devcontainer 文件夹中的 devcontainer.json 和 Dockerfile，通过定义镜像、扩展、端口转发及调试器 debugpy 并映射路径，使团队成员开箱即用，避免环境不一致问题。

vs code远程容器开发：docker环境配置与调试方案

使用 VS Code 进行远程容器开发，能让你在隔离、一致的 Docker 环境中编写和调试代码，特别适合团队协作和复杂依赖项目。整个流程核心在于 Dev Container 配置，通过定义容器环境实现“开箱即用”的开发体验。

配置 Dev Container 环境

VS Code 的 Remote-Containers 扩展允许你将开发环境完全运行在容器中。要启用该功能，需在项目根目录创建 .devcontainer 文件夹，并包含以下两个关键文件：

devcontainer.json

这个文件定义开发容器的行为，比如使用哪个镜像、挂载路径、扩展推荐等。一个基础配置示例如下：

{
  "name": "My Dev Container",
  "image": "mcr.microsoft.com/vscode/devcontainers/python:3.11",
  "features": {},
  "customizations": {
    "vscode": {
      "extensions": [
        "ms-python.python",
        "ms-python.debugpy"
      ],
      "settings": {
        "python.defaultInterpreterPath": "/usr/local/bin/python"
      }
    }
  },
  "forwardPorts": [8000, 3000],
  "postAttachCommand": "pip install -r requirements.txt"
}

登录后复制

你也可以使用 Dockerfile 自定义镜像，通过 "dockerFile": "Dockerfile" 指定。这样可以安装特定工具、设置用户权限或预装依赖。

构建可调试的容器环境

要在容器中调试代码，关键是让调试器（如 debugpy）能在容器内运行并暴露端口供 VS Code 连接。

以 Python 为例，在 Dockerfile 中安装 debugpy：

<pre class="brush:php;toolbar:false;">RUN pip install debugpy

登录后复制

然后在代码启动时加入监听逻辑：

python -m debugpy --listen 0.0.0.0:5678 --wait-for-client app.py

登录后复制

注意绑定到 0.0.0.0 并开放端口。在 devcontainer.json 中添加端口转发：

白瓜面试

白瓜面试 - AI面试助手,辅助笔试面试神器

查看详情

"forwardPorts": [5678]

登录后复制

这样 VS Code 就能通过 localhost:5678 连接到容器内的调试器。

VS Code 调试配置对接容器

在项目根目录的 .vscode/launch.json 中添加调试配置：

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

登录后复制

确保 pathMappings 正确映射本地与容器路径。启动容器后，先运行带 debugpy 的服务，再在 VS Code 中启动该调试配置即可断点调试。