必须安装Remote-Containers扩展并配置.devcontainer/devcontainer.json，VSCode才可接管容器内完整开发环境；Docker插件仅管理容器，不支持开发环境挂载。
VSCode 用 Docker 插件本身不能运行开发容器——它只负责“看容器”，真正接管开发环境必须靠 Remote-Containers 扩展和 .devcontainer/devcontainer.json 配置。
为什么点“Reopen in Container”没反应或卡在 Building image…
根本不是插件没装对，而是 Docker CLI 不可用或权限没通。VSCode 的 Remote-Containers 完全依赖本地 docker 命令执行构建、启动、挂载等操作。
- 在终端运行
docker info，如果报permission denied或连接失败，说明 Docker daemon 没起来，或当前用户不在docker组（Linux/macOS） - Windows/macOS 用户要确认 Docker Desktop 正在运行；Linux 用户需执行
sudo systemctl start docker并加组：sudo usermod -aG docker $USER，然后**完全退出并重登系统** - 别用
sudo code启动 VSCode——这会让容器内进程 UID 错乱，后续git clone或npm install直接 Permission denied
devcontainer.json 放错位置或字段写漏的典型表现
VSCode 只认项目根目录下 .devcontainer/devcontainer.json 这一个路径。放错地方、名字拼错、或者关键字段缺失，都会导致“看似配置了，实则没生效”。
-
"image"和"build"必须二选一填，不能都空着；用"build"时，"dockerFile"路径是相对于.devcontainer/的，比如"dockerFile": "Dockerfile" -
"forwardPorts"漏写，服务明明在容器里跑着（npm start输出Listening on http://localhost:3000），但 VSCode 右下角不显示可点击链接，宿主机也打不开localhost:3000 -
"customizations.vscode.extensions"不配，容器里就只有裸编辑器，ms-python.python、esbenp.prettier-vscode全都不见，格式化、调试、语法检查全部失效
容器内文件权限错乱：git status 总显示 modified
这不是 Git 问题，是 UID/GID 不匹配。VSCode 默认以宿主机当前用户的 UID 启动容器进程，但多数官方镜像（如 python:3.11-slim）只有 root 用户，没创建对应 UID 的普通用户。
- 最稳解法：在
devcontainer.json中加这两行："remoteUser": "vscode"和"runArgs": ["--user", "vscode"] - 同时在自定义
Dockerfile里创建该用户：RUN useradd -m -u 1001 -G sudo vscode - 千万别设
"remoteUser": "root"——虽然能过构建，但所有生成文件属主都是root:root，协作时git commit会因权限拒绝失败
Remote-Containers 日志藏得深，错误不弹窗只闪一下
很多问题根本不会报红框，比如 postCreateCommand 失败、端口转发失败、插件安装超时，全都在 Dev Container 日志里一闪而过。
- 务必养成习惯：点 VSCode 右下角状态栏的
Dev Container，再点 “Show Log” -
forwardPorts漏写时，日志里会出现类似Port 3000 not forwarded的提示，但 UI 上毫无反馈 - 插件安装失败时，日志里会明确写
Failed to install extension xxx，而不是静默跳过
真正麻烦的不是写几行 JSON，而是这些错误既不报错也不提示，全靠翻日志、看状态栏、比对 UID——稍不注意，就陷入“容器起来了，但代码跑不了、文件存不了、端口连不上”的三不管状态。
