VSCode Dev Containers 通过容器化实现开发环境隔离与复用。需安装 Docker、VSCode 及官方扩展；可选模板自动生成 devcontainer.json；支持镜像替换、工具安装、目录挂载、端口转发；配置提交 Git 即可团队共享，确保环境一致。
VSCode Dev Containers 让你把整个开发环境打包进容器，代码在容器里运行、调试、依赖全隔离，本地只留编辑器——真正“所见即所得”的云原生开发体验。
一、基础准备：装好工具，拉通链路
确保本地已安装 Docker（引擎必须运行）和 VSCode（推荐最新稳定版）。再装上官方扩展 Dev Containers（Microsoft 出品，认准作者名）。不需要手动写 Dockerfile 也能起步：VSCode 提供大量预配置的 devcontainer.json 模板（比如 Node.js、Python、Go），一键生成即可用。
二、快速启动：从模板开箱即用
打开你的项目文件夹 → 按 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（Mac）→ 输入 Dev Container: Add Development Container Configuration Files → 选择语言/框架模板 → VSCode 自动创建 .devcontainer/ 目录，含 devcontainer.json 和可选的 Dockerfile。
- devcontainer.json 定义容器行为：镜像来源、端口转发、扩展自动安装、启动命令等
- 默认使用托管镜像（如
mcr.microsoft.com/vscode/devcontainers/node:18），省去自己维护基础镜像的麻烦 - 点右下角绿色按钮 Reopen in Container，VSCode 自动构建、启动容器，并重连工作区
三、深度定制：按需调整开发环境
常见定制场景直接改 devcontainer.json 即可：
-
换基础镜像：改
"image"字段，或用"build": { "dockerfile": "Dockerfile" }指向自定义构建逻辑 -
装额外工具：在
"features"中添加微软官方特性（如"ghcr.io/devcontainers/features/git:1"），免写 apt/yum 命令 -
挂载本地目录：通过
"mounts"字段绑定宿主机路径（如数据库数据卷、配置文件），避免容器重启丢数据 -
端口转发：设
"forwardPorts"后，本地浏览器访问localhost:3000就能直连容器内服务
四、协作与复用：一次配置，多人开箱
把 .devcontainer/ 提交到 Git，团队成员克隆代码后只需点击 Reopen in Container，就能获得完全一致的环境——没有“在我机器上是好的”问题。还可把常用配置发布为 dev container definition（GitHub 上已有大量开源模板），或基于它衍生私有模板，统一公司级开发标准。
基本上就这些。不复杂但容易忽略的是：容器内 PATH、shell 配置、Git 用户信息最好也在 devcontainer.json 里初始化好，避免每次重进都要手动配。
