使用 VSCode 的 Remote - Containers 扩展可在容器中开发，确保环境一致且不影响本地系统。首先安装 Docker、VSCode 及 Remote - Containers 扩展。在项目根目录创建 .devcontainer 文件夹，包含 devcontainer.json 和可选 Dockerfile。配置文件定义镜像、依赖、端口转发和扩展等。通过命令面板执行 “Reopen in Container” 启动，VSCode 自动构建镜像、挂载项目、应用设置并进入容器环境。终端与工具均运行于容器内，保证一致性。可挂载 SSH 密钥、运行初始化命令，并支持多环境配置。避免容器内持久化数据，问题可通过远程资源管理器日志排查。配置一次后，团队成员可一键复用统一环境，提升协作效率。
使用 VSCode 的 Remote - Containers 扩展，可以直接在隔离的容器环境中进行开发，既能保证环境一致性，又不影响本地系统。整个流程简单高效，特别适合团队协作和复杂依赖项目。
安装与准备
确保你的开发机器已安装以下工具：
- Docker：负责运行和管理容器
- Visual Studio Code：推荐使用最新版本
- Remote - Containers 扩展：在 VSCode 扩展市场中搜索并安装
安装完成后，VSCode 就具备了将开发环境“搬进”容器的能力。
配置开发容器
在项目根目录下创建 .devcontainer 文件夹，并添加两个关键文件：
- devcontainer.json：定义容器启动配置
- Dockerfile（可选）：自定义镜像构建步骤
示例 devcontainer.json 内容：
{
"name": "My Dev Container",
"image": "mcr.microsoft.com/vscode/devcontainers/base:ubuntu",
"features": {
"git": "latest"
},
"forwardPorts": [3000, 5000],
"postAttachCommand": "npm install",
"customizations": {
"vscode": {
"extensions": ["ms-vscode.vscode-typescript-next"],
"settings": {
"terminal.integrated.shell.linux": "/bin/bash"
}
}
}
}你也可以用 Dockerfile 构建专用镜像，只需把 image 替换为 dockerFile 字段指向该文件。
启动容器化开发环境
按下 F1 或 Ctrl+Shift+P 打开命令面板，输入 “Remote-Containers: Reopen in Container”，回车执行。
VSCode 会自动：
- 构建或拉取指定镜像
- 启动容器并挂载当前项目目录
- 应用扩展、端口转发和初始化命令
连接成功后，终端和编辑器都在容器内部运行，npm、python、node 等命令使用的都是容器内的环境。
实用技巧与注意事项
提升使用体验的一些常见做法：
- 通过 mounts 挂载本地工具（如 SSH 密钥）
- 使用 onCreateCommand 安装构建工具（比如 make、cmake）
- 配合 .devcontainer/devcontainer.json 的 variants 使用多环境（如 dev、test）
- 避免在容器内长期存储数据，所有更改应保留在挂载的项目目录中
如果容器启动失败，可通过 VSCode 的“远程资源管理器”查看日志，排查 Dockerfile 或配置问题。
基本上就这些。只要配好一次 .devcontainer，团队成员打开项目时就能一键进入统一环境，省去“在我机器上是好的”这类麻烦。
