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

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

使用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：

<font face="monospace"> {   "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"       }     }   } } </font>

配套 Dockerfile 示例：

Calliper 文档对比神器

文档内容对比神器

28

查看详情

<font face="monospace"> FROM node:18-slim WORKDIR /workspace </font>

3. 启动容器开发环境

打开项目文件夹后，点击右下角绿色标签“< >”图标，选择 Reopen in Container。VSCode会自动：

• 构建镜像（如需）
• 启动容器
• 挂载当前项目目录
• 应用扩展和设置

首次运行可能耗时稍长，后续启动通常只需几秒。

4. 日常使用与调试

进入容器后，所有终端命令都在容器内执行。你可以：

• 使用内置终端运行 npm start 或 python app.py
• 直接调试服务，端口会自动转发到本地浏览器
• 修改 .devcontainer 配置后，可用“Rebuild Container”更新环境

关闭连接可用“Close Remote Connection”，容器默认停止但不删除。

基本上就这些。只要配置一次，团队成员都能获得完全一致的开发环境。不复杂但容易忽略的是Docker权限和卷挂载路径问题，建议保持项目路径简洁。