Dev Containers是VSCode将开发环境打包进Docker容器的沙盒方案，需严格满足路径（.devcontainer/devcontainer.json）、命名（大小写敏感）和打开方式（Open Folder）三个前提，否则Reopen in Container按钮不生效。
能直接用，但必须满足三个硬性前提：工作区根目录存在 .devcontainer 文件夹、里面放着大小写完全匹配的 devcontainer.json、VS Code 是通过 Open Folder 方式打开该工作区。
点“Reopen in Container”没反应？先查这四件事
90% 的失败不是配置写错，而是结构或路径不合规：
-
.devcontainer必须是文件夹名，不能是文件，也不能叫.devcontainer.json或devcontainer -
devcontainer.json必须放在.devcontainer/子目录里，不能放在项目根目录或其他位置 - 文件名大小写必须严格为
devcontainer.json（Linux 容器环境区分大小写，Windows 用户改完也要注意） - VS Code 必须本地启用
Remote - Containers插件，且版本 ≥ 1.76；远程 SSH/WSL 场景下插件默认不生效，需手动启用
最小可用配置怎么写？别抄复杂模板
多数 Python 项目不需要自定义 Dockerfile，复用微软官方镜像最稳：
{
"image": "mcr.microsoft.com/devcontainers/python:3",
"features": {
"ghcr.io/devcontainers/features/git:1": {}
},
"postCreateCommand": "pip install -r requirements.txt"
}说明：
立即学习“Python免费学习笔记（深入）”；
-
image值用:3自动匹配最新 Python 3.x，比硬写:3.12更少维护负担 -
features替代了手动RUN apt install，Git、curl、GitHub CLI 等都可按需开启 -
postCreateCommand在容器首次创建后执行，适合装项目依赖；若用uv，就写uv sync
容器进得去，但代码没同步 / 终端 pwd 错 / 端口打不开？
这不是插件故障，而是挂载和网络配置没对齐预期：
- VS Code 默认把当前工作区完整挂载到容器内
/workspaces/<folder-name>；如果改了workspaceFolder字段，终端pwd就会错位，git提交也可能失败 - Flask/FastAPI 启动在 8000 端口，宿主机却访问不到？必须显式声明
"forwardPorts": [8000] - 调试断点不命中？检查
python.defaultInterpreterPath是否设为容器内路径（如/usr/bin/python3），而不是宿主机路径 - Windows + WSL2 用户注意：Docker Desktop 启用 WSL2 后端时，VS Code 也必须运行在 WSL2 中，否则文件同步延迟或权限报错
真正容易被忽略的是：容器启动后 VS Code 的扩展是分层加载的——宿主机装的插件只在宿主机界面生效，extensions 字段里列出的才真正在容器内安装并可用。
