VS Code Dev Containers：用Docker定义你的开发环境-VSCode-PHP中文网

VS Code Dev Containers：用Docker定义你的开发环境

P粉986688829

发布： 2025-12-09 17:00:17

原创

159人浏览过

Dev Containers 用 Docker 容器封装完整开发环境，确保跨机器、系统、团队的一致性；通过预建镜像和 devcontainer.json 声明式配置，5 分钟快速复现环境，避免本地安装的版本冲突与污染。

vs code 的 dev containers 功能，让你用 docker 容器“装”整个开发环境——代码、工具、依赖、配置全打包，换机器、换系统、换队友，一键复现，彻底告别“在我电脑上是好的”。

为什么 Dev Containers 比本地安装更可靠

本地装 Node、Python、JDK、数据库客户端……版本冲突、路径污染、权限问题、文档没写清楚的隐式依赖，太常见。Dev Containers 把一切锁死在容器镜像里，启动即一致。

所有命令（npm install、pip install、make）都在容器内执行，不污染宿主机
VS Code 的扩展（如 Python、Go、ESLint）可分别配置为“仅在容器中启用”，避免本地和容器环境错配
团队共享一个 .devcontainer/devcontainer.json，新人克隆仓库后点一下“Reopen in Container”，5 分钟进入编码状态

一个最小可用的 devcontainer.json 长什么样

不需要从零写 Dockerfile。VS Code 提供大量预构建镜像，比如 mcr.microsoft.com/vscode/devcontainers/python:3.11，已含 Python、pip、venv、git 和常用编译工具。

在项目根目录建 .devcontainer/devcontainer.json：

{
  "image": "mcr.microsoft.com/vscode/devcontainers/python:3.11",
  "forwardPorts": [8000, 3000],
  "customizations": {
    "vscode": {
      "extensions": ["ms-python.python", "esbenp.prettier-vscode"]
    }
  }
}

登录后复制

保存后按 Ctrl+Shift+P → “Dev Containers: Reopen in Container”，VS Code 自动拉镜像、启动容器、挂载当前目录、安装扩展。

需要自定义环境？Dockerfile 比想象中简单

当预建镜像不够用（比如要加 PostgreSQL 客户端、特定 CUDA 版本、私有 npm registry），就写个轻量 Dockerfile，再指向它：

捏Ta

捏Ta 是一个专注于角色故事智能创作的AI漫画生成平台

297

查看详情

"build": {
  "dockerfile": "Dockerfile"
}

登录后复制

示例（基于 Python 镜像加 pgcli）：

FROM mcr.microsoft.com/vscode/devcontainers/python:3.11
RUN pip install pgcli
ENV LANG=C.UTF-8

登录后复制

VS Code 构建时自动缓存层，后续修改只重跑变更部分，不慢。

进阶但实用：挂载、端口、初始化脚本

真实开发绕不开这些细节：

挂载宿主机配置：用 mounts 字段把 ~/.ssh 或 ~/.gitconfig 挂进容器，免密登录、保留 Git 账号
启动即运行服务：用 onCreateCommand 启动 Redis 或数据库，或用 postCreateCommand 自动 pip install -r requirements.txt
多容器协作：通过 docker-compose.yml 定义 app + db + cache，Dev Containers 原生支持，devcontainer.json 中设 "dockerComposeFile": "docker-compose.yml"