VSCode Dev Containers 通过 Dockerfile 和 devcontainer.json 将开发环境定义为代码，实现跨机器一致环境；需配置 image/build、forwardPorts、extensions 等字段，并注意路径、大小写及 git 身份等常见问题。
用 VSCode Dev Containers 能让团队成员在各自机器上运行完全一致的开发环境，避免“在我电脑上是好的”这类问题。核心思路是把开发环境定义成代码（Dockerfile + devcontainer.json），提交到仓库，其他人一键复用。
基础配置：从 Docker 镜像开始
Dev Containers 依赖一个可运行的 Docker 镜像。你可以直接复用官方镜像（如 mcr.microsoft.com/vscode/devcontainers/python:3.11），也可以基于它自定义——比如加 Node.js、数据库客户端或特定 CLI 工具。推荐优先使用官方 devcontainer 基础镜像，它们已预装 VSCode Server 和常用工具链，启动快、兼容性好。
- 在项目根目录新建 .devcontainer/ 文件夹
- 放入 Dockerfile（可选，仅需定制时写）
- 必须有 devcontainer.json，声明镜像、端口转发、扩展、挂载等
关键配置项：devcontainer.json 实用字段
这个文件是 Dev Container 的“说明书”。几个高频且易出错的字段要注意：
- image 或 build：二选一。用 image 直接拉镜像；用 build 指向 Dockerfile 构建本地镜像
- forwardPorts：例如 [3000, 5432]，VSCode 自动把容器内端口映射到本机，浏览器直连 http://localhost:3000 即可
- customizations.vscode.extensions：写死团队必需的扩展 ID，如 ms-python.python，打开容器时自动安装
- mounts：慎用 bind mount。推荐用 workspaceMount 控制工作区挂载方式，避免 Windows/macOS 路径差异导致权限或性能问题
进阶技巧：提升协作与复用效率
单个项目配一套没问题，但多个服务共用相似环境时，可以进一步抽象：
CRMEB 多语言开源商城系统
下载
CRMEB打通版是一款全开源支持免费商用的PHP 多语言商城系统；CRMEB技术团队历经6年时间匠心之作！系统采用前后端分离技术，基于TP6+Uni-app框架开发；客户移动端采用uni-app开发，管理后台前端使用iviewUI开发。系统支持微信公众号端、微信小程序端、H5端、PC端多端账号同步，可快速打包生成APP；赋能开发者，减少重复造轮子；系统支持自动检查安装环境一键安装部署，使用简单方便
- 把通用配置抽成 devcontainer-templates（GitHub 上已有不少开源模板），用 devcontainer.json 中的 features 字段按需组合，比如添加 redis、postgresql、github-cli 等标准化组件
- 用 postCreateCommand 自动执行初始化脚本（如 pip install -r requirements.txt、yarn install），省去手动操作
- 配合 settings.json（放在 .devcontainer/ 下）统一编辑器偏好，比如默认启用 Prettier、禁用特定检查项，确保格式和提示一致
常见问题速查
刚上手容易卡在几个点：
- “Reopen in Container” 灰掉？ 检查 .devcontainer/ 目录是否在工作区根路径，且文件名大小写正确（必须是 devcontainer.json，不是 DevContainer.json）
- 容器启动后没反应？ 查看 VSCode 右下角状态栏的 Dev Container 图标，点击可打开日志，重点看 postCreateCommand 是否报错或超时
- Git 提交显示 “Author identity unknown”？ 在 devcontainer.json 的 remoteUser 或 postCreateCommand 里配置 git user.name/user.email，或挂载宿主机 ~/.gitconfig
基本上就这些。Dev Containers 不复杂，但容易忽略细节。把环境当代码管起来，一次配好，处处可用。
