<p>Dev Containers 是 VSCode 的容器化开发环境机制，用于在隔离、可复现的 Docker 容器中启动完整开发环境（含运行时、工具链、依赖等）；适用于避免本地环境污染、跨平台开发、团队环境一致等场景，需配置 .devcontainer/devcontainer.json（必需）和可选的 Dockerfile，依赖 Remote - Containers 扩展与本地 Docker 引擎。</p>
Dev Containers 是什么，什么时候该用它
Dev Containers 不是 Docker Desktop 的替代品，也不是用来跑生产服务的。它是 VSCode 的一个扩展机制，把整个开发环境（包括语言运行时、依赖、工具链）打包进容器里，让你在项目根目录下打开 VSCode 时，自动连接到一个干净、可复现、与宿主机隔离的环境里运行代码。
适合用它的场景很明确：git clone 下来一个别人写的 Python/Node/Rust 项目，你不想装 pyenv、nvm 或一堆系统级依赖；或者你在 Windows 上开发 Linux-only 工具，又不想开完整虚拟机；再或者团队要求“所有开发者必须用完全一致的 gcc 版本编译 C++”。
初始化 Dev Container 需要哪几个文件
VSCode 不会自动猜你要什么环境，必须手动提供最小配置。核心就两个文件，缺一不可：
-
.devcontainer/devcontainer.json：定义容器行为，比如用哪个镜像、挂载哪些路径、启动后执行什么命令 -
.devcontainer/Dockerfile（可选但推荐）：如果你需要定制基础镜像（比如加apt install libpq-dev），就写在这里；否则可以直接在devcontainer.json里指定现成镜像如mcr.microsoft.com/vscode/devcontainers/python:3.11
注意：.devcontainer 目录必须在项目根目录下，不能放在子目录；VSCode 只认这个路径。如果已有 Dockerfile 在项目根，不要直接复用——它可能暴露端口、启动后台服务，而 devcontainer.json 默认只启动一个交互式 shell，行为不兼容。
常见启动失败原因和对应修复
打开项目后点击 “Reopen in Container”，卡在 “Building image…” 或报错，大概率是下面这几个问题：
- VSCode 没装
Remote - Containers扩展：去 Extensions 商店搜这个名字，装完重启 VSCode - 本地没运行 Docker 引擎：Windows/macOS 要开 Docker Desktop；Linux 用户得确认
docker命令可用且当前用户在docker组里（否则会报Permission denied while trying to connect to the Docker daemon socket） -
devcontainer.json里写了不存在的镜像名：比如误写成python:3.11-buster（正确是python:3.11-bullseye），Docker 拉不到镜像就会停住 - 挂载路径冲突：比如
"workspaceMount": "source=${localWorkspaceFolder},target=/workspace,type=bind,consistency=cached"在 macOS 上如果路径含中文或空格，可能失败；建议用英文路径初始化项目
进容器后怎么真正运行代码
容器启动成功后，VSCode 窗口右下角会显示 “Dev Container” 状态，终端也自动切换到容器内。这时你运行的每条命令都发生在容器中：
- Python 项目：直接
python main.py，用的是容器里的python和pip安装的包，跟宿主机完全无关 - 调试时按
F5：VSCode 自动把断点、变量监听等转发到容器进程，不需要额外配launch.json的远程地址 - 端口暴露：如果代码监听
0.0.0.0:3000，在devcontainer.json加上"forwardPorts": [3000]，VSCode 就会把宿主机的localhost:3000自动映射过去 - Git 提交仍走宿主机凭据：因为
.gitconfig默认从宿主机挂载进来，但ssh-agent不自动透传，需要用"runArgs": ["--ssh", "default"]手动启用
容器里改的代码实时同步，但安装的全局工具（比如 npm install -g eslint）只在当前容器生效；下次重建容器就得重装——这不是 bug，是设计使然。真要持久化工具，得写进 Dockerfile 或用 postCreateCommand。
