使用 VSCode Dev Containers 可解决多项目或团队开发环境不一致问题：需安装 Dev Containers 扩展和 Docker Desktop，初始化并自定义 .devcontainer/devcontainer.json，构建启动容器，最后共享配置至代码仓库。
如果您在多个项目或团队成员间遇到开发环境不一致的问题，例如依赖版本差异、工具链缺失或配置文件冲突，则可能是由于本地开发环境缺乏标准化。以下是使用 VSCode Dev Containers 实现一致开发环境的具体操作步骤：
本文运行环境：MacBook Pro，macOS Sequoia。
一、安装必要组件
Dev Containers 功能依赖 VSCode 官方扩展和 Docker 运行时，需确保两者均就绪才能启用容器化开发流程。
1、打开 VSCode，进入 Extensions 视图，搜索并安装 Dev Containers 扩展。
2、访问 Docker 官网下载并安装 Docker Desktop，启动后确认其状态栏图标显示为运行中。
3、在终端执行 docker --version 与 code --version，验证两个命令均能正常返回版本信息。
二、初始化 Dev Container 配置
VSCode 通过 .devcontainer/devcontainer.json 文件定义容器运行时行为，该文件可手动创建或由命令面板自动生成，用于声明基础镜像、端口映射及扩展依赖。
1、在项目根目录下新建文件夹 .devcontainer。
2、在 VSCode 中按 Cmd+Shift+P（macOS）调出命令面板，输入并选择 Dev Containers: Add Development Container Configuration Files...。
3、从模板列表中选择匹配项目技术栈的选项，例如 Node.js & TypeScript 或 Python 3，完成配置生成。
三、自定义 devcontainer.json 文件
默认生成的配置可能未覆盖全部开发需求，需手动编辑以添加环境变量、挂载路径、预安装命令等关键参数，从而确保容器内行为与预期完全一致。
1、打开 .devcontainer/devcontainer.json，添加 "forwardPorts" 字段，填入项目常用端口如 [3000, 8080]。
2、在 "customizations" 下的 "vscode" 节点中，加入 "extensions" 数组，填入必需扩展 ID，例如 "esbenp.prettier-vscode"。
3、添加 "postCreateCommand" 字段，设置为 "npm install" 或 "pip install -r requirements.txt"，确保容器构建后自动完成依赖安装。
四、构建并启动开发容器
VSCode 将基于配置文件拉取指定镜像、执行初始化脚本，并将工作区完整挂载进容器内部，使所有编辑、调试、终端操作均在隔离且复现性强的环境中进行。
1、打开项目文件夹后，按 Cmd+Shift+P，输入并选择 Dev Containers: Reopen in Container。
2、首次执行时，VSCode 自动触发 docker build 流程，控制台输出日志显示镜像构建进度。
3、构建完成后，窗口右下角状态栏显示 Dev Container 标识，集成终端自动切换至容器内 Shell 环境。
五、复用与共享配置
已验证有效的 .devcontainer 配置可直接提交至代码仓库，使其他协作者一键复现相同环境，消除“在我机器上能跑”的协作障碍。
1、将整个 .devcontainer 目录纳入 Git 版本控制，确保 devcontainer.json 与任何 Dockerfile 均被提交。
2、在项目 README.md 中添加说明，提示新成员使用 Cmd/Ctrl + Shift + P → Dev Containers: Reopen in Container 启动环境。
3、若项目需多环境支持（如测试/生产差异化依赖），可在 .devcontainer 下建立子目录，例如 .devcontainer/test 和 .devcontainer/prod，并通过命令面板选择对应配置。
