VSCode通过Remote-Containers扩展调用本地Docker命令实现容器化开发，依赖devcontainer.json声明式配置镜像、扩展、端口等；必须正确设置image或build、extensions、forwardPorts及remoteUser，确保Docker daemon可访问且容器用户权限与挂载路径匹配。
VSCode 本身不管理 Docker，它只调用你本地的 docker 命令；没装好 Docker CLI 或 daemon 不响应，所有扩展都会卡在 “Cannot connect to the Docker daemon”。
devcontainer.json 配置错一个字段，容器就起不来
VSCode 的 Remote-Containers 功能完全依赖 .devcontainer/devcontainer.json，不是放个 Dockerfile 就能跑。常见失效点：
-
"image"和"build"必须二选一，不能都空着，也不能同时存在 - 用
"image"时，优先选mcr.microsoft.com/vscode/devcontainers/python:3.11这类官方预置镜像，别直接用python:3.11-slim——它缺git、curl、bash，连pip install都可能失败 -
"customizations.vscode.extensions"必须显式写，比如["ms-python.python", "esbenp.prettier-vscode"]；容器里不会自动同步你本地装的插件 -
"forwardPorts"是调试刚需：Flask 默认跑5000，就得写[5000]，否则宿主机localhost:5000打不开
Remote-Containers 连不上 Docker daemon 的真实原因
它不走 SSH，是直连远端的 /var/run/docker.sock。报错 “Cannot connect to the Docker daemon” 通常不是网络问题，而是权限或配置没对：
- 远程机器上运行
sudo docker ps要成功；若必须加sudo，说明当前用户不在docker组，VSCode 不支持sudo连接 - 执行
sudo usermod -aG docker $USER后，必须彻底退出 shell 再登录（newgrp docker不生效） - 如果跨主机连接（比如 Windows 主机连 Linux 服务器），需改
/etc/docker/daemon.json加"hosts": ["tcp://0.0.0.0:2375"]，并开放防火墙端口——注意2375不加密，别在生产环境开
容器内文件权限混乱，Git 提交失败
默认挂载进来的代码目录属主是 root，你在 VSCode 里新建文件，ls -l 看到的是 root:root；但本地 git 操作又以你自己的 UID 运行，混着来就触发 permission denied 或状态异常。
- 在
devcontainer.json里加"remoteUser": "vscode"和"runArgs": ["--user", "vscode"] - 如果用了自定义
Dockerfile，必须在里面创建该用户：RUN useradd -m -u 1001 -G sudo vscode，再USER vscode -
"containerUser"才是真正决定 VSCode Server 和/workspace写入权限的字段；"remoteUser"只影响你手动打开终端时的默认用户，一般不用单独设
Docker 扩展只能看日志，不能进容器写代码
官方 Docker 扩展（发布者 Microsoft）和 Remote-Containers 是两套东西：前者是“遥控器”，后者才是“开发环境载体”。它们分工明确：
-
Docker扩展提供侧边栏查看镜像/容器、右键Logs或Attach Shell——但Attach Shell进去只是临时终端，不加载你的项目配置、不转发端口、不装插件 -
Remote-Containers才会把 VSCode Server 装进容器，编辑、调试、终端全在容器上下文中运行，路径、依赖、环境变量才真正一致 - 想用
Docker扩展辅助排查，可以右键容器 →Inspect查配置，或View Logs看启动失败原因；但“写代码”这件事，必须走Reopen in Container流程
最易被忽略的一点：所有配置最终都落到容器内的用户权限和文件挂载方式上。哪怕 devcontainer.json 语法全对，只要 containerUser 对应的用户没 home 目录、没写入 /workspace 权限，或者挂载路径用了符号链接而容器内不识别，就会静默失败——得去 Dev Container 日志里翻 Remote-Containers: Show Log，而不是盯着弹窗等提示。
