VSCode远程：容器开发环境搭建

苏承栈

2026-09-28 • 👁 0人浏览过

使用VSCode进行远程容器开发需安装Docker和Remote - Containers扩展，1. 在项目根目录创建.devcontainer文件夹并配置devcontainer.json与Dockerfile；2. 点击右下角“<>”图标选择Reopen in Container，VSCode将自动构建容器、挂载项目、安装依赖；3. 容器启动后可在终端执行命令、调试服务，端口自动转发，修改配置后可重建容器。配置一次即可实现团队环境一致，注意Docker权限与项目路径设置。

使用VSCode进行远程容器开发，能让你在隔离、可复用的环境中高效编码。核心工具是 Dev Containers （由Remote - Containers扩展提供），它允许你将Docker容器作为完整的开发环境。 1. 前置条件准备确保本地已安装以下组件： Docker ：桌面版或引擎服务正常运行 Visual Studio Code Remote - Containers 扩展：在VSCode扩展市场搜索并安装启动Docker服务后，在终端执行

docker info

验证是否正常。 2. 创建Dev Container配置文件在项目根目录下创建

.devcontainer

文件夹，并添加两个关键文件： devcontainer.json ：定义容器行为 Dockerfile （可选）：自定义镜像构建示例

devcontainer.json

：


{
  "name": "My Dev Env",
  "build": {
    "dockerfile": "Dockerfile"
  },
  "forwardPorts": [3000, 5000],
  "postAttachCommand": "npm install",
  "customizations": {
    "vscode": {
      "extensions": ["ms-vscode.vscode-typescript-next"],
      "settings": {
        "terminal.integrated.shell.linux": "/bin/bash"
      }
    }
  }
}

配套

Dockerfile

示例： php版微信js-sdk支付接口类 php版微信js-sdk支付接口类下载


FROM node:18-slim
WORKDIR /workspace

3. 启动容器开发环境打开项目文件夹后，点击右下角绿色标签“< >”图标，选择 Reopen in Container 。VSCode会自动：构建镜像（如需）启动容器挂载当前项目目录应用扩展和设置首次运行可能耗时稍长，后续启动通常只需几秒。 4. 日常使用与调试进入容器后，所有终端命令都在容器内执行。你可以：使用内置终端运行

npm start

或

python app.py

直接调试服务，端口会自动转发到本地浏览器修改

.devcontainer

配置后，可用“Rebuild Container”更新环境关闭连接可用“Close Remote Connection”，容器默认停止但不删除。基本上就这些。只要配置一次，团队成员都能获得完全一致的开发环境。不复杂但容易忽略的是Docker权限和卷挂载路径问题，建议保持项目路径简洁。

相关文章