VSCode远程开发：配置Docker容器内开发的完整环境-VSCode-PHP中文网

VSCode远程开发：配置Docker容器内开发的完整环境

夜晨

发布： 2025-10-24 23:20:02

原创

777人浏览过

<p>答案：使用 VSCode 远程开发可在 Docker 容器中搭建隔离、一致的开发环境。需安装 Docker、VSCode 及 Remote - Containers 扩展，创建 .devcontainer 目录并配置 Dockerfile 和 devcontainer.json，通过命令面板选择 Reopen in Container 即可自动构建并连接容器，实现团队环境统一与“一键进入”开发。</p>

vscode远程开发：配置docker容器内开发的完整环境

使用 VSCode 进行远程开发，可以在隔离的 Docker 容器中搭建完整、可复用的开发环境。这种方式特别适合团队协作、保持环境一致性以及避免“在我机器上能跑”的问题。以下是配置基于 Docker 容器的 VSCode 远程开发环境的完整流程。

1. 准备工作：安装必要组件

要实现 VSCode 远程容器开发，需确保本地系统已安装以下工具：

Docker：用于运行和管理容器，支持 Linux、macOS 和 Windows（推荐使用 WSL2）
VSCode：最新版官方编辑器
Remote - Containers 扩展：在 VSCode 扩展市场中搜索并安装 “Remote - Containers”

安装完成后重启 VSCode，扩展会自动启用远程开发功能。

2. 创建项目结构与配置文件

在你的项目根目录下创建 .devcontainer 文件夹，并添加两个关键文件：Dockerfile 和 devcontainer.json。

示例目录结构：

my-project/
├── .devcontainer/
│   ├── Dockerfile
│   └── devcontainer.json
├── src/
└── README.md

登录后复制

Dockerfile 示例：定义开发镜像

FROM python:3.11-slim
<h1>设置工作目录</h1><p>WORKDIR /workspace</p><h1>安装常用工具和依赖</h1><p>RUN apt-get update && apt-get install -y \
git \
curl \
vim \
&& rm -rf /var/lib/apt/lists/*</p><h1>安装 Python 依赖（可选）</h1><p>COPY requirements.txt ./
RUN pip install --no-cache-dir -r requirements.txt</p><h1>暴露调试端口（如需要）</h1><p>EXPOSE 8000</p><p>CMD ["sleep", "infinity"]  # 保持容器运行</p>
                    <div class="aritcle_card">
                        <a class="aritcle_card_img" href="/ai/1961">
                            <img src="https://img.php.cn/upload/ai_manual/001/246/273/68b6d112d0513186.png" alt="Trae国内版">
                        </a>
                        <div class="aritcle_card_info">
                            <a href="/ai/1961">Trae国内版</a>
                            <p>国内首款AI原生IDE，专为中国开发者打造</p>
                            <div class="">
                                <img src="/static/images/card_xiazai.png" alt="Trae国内版">
                                <span>815</span>
                            </div>
                        </div>
                        <a href="/ai/1961" class="aritcle_card_btn">
                            <span>查看详情</span>
                            <img src="/static/images/cardxiayige-3.png" alt="Trae国内版">
                        </a>
                    </div>

登录后复制

devcontainer.json 示例：配置 VSCode 如何连接容器

{
  "name": "Python Dev Container",
  "build": {
    "dockerfile": "Dockerfile"
  },
  "settings": {
    "python.defaultInterpreterPath": "/usr/local/bin/python"
  },
  "appPort": [8000],
  "postAttachCommand": "pip install -e .",  // 可选：连接后执行命令
  "remoteUser": "root",
  "workspaceFolder": "/workspace"
}

登录后复制