VSCode的Docker扩展仅连接本地Docker引擎，不运行容器；需确保dockerd已启动且docker命令可用，Linux用户须将用户加入docker组并重登，扩展核心价值在于配合Dev Container实现容器内调试。
VSCode 的 Docker 扩展本身不运行或管理容器，它只是连接并操作你本地已安装的 Docker 引擎（dockerd）——如果你没装 Docker Desktop 或 docker-ce，装了扩展也完全没用。
确认本地 Docker 引擎已就绪
扩展依赖命令行 docker 可执行且能通信。常见失效原因不是扩展装错了，而是引擎没跑起来：
- macOS / Windows：确保 Docker Desktop 已启动，托盘图标是绿色（非灰色或报错状态）
- Linux：运行
sudo systemctl is-active docker应返回active；若为inactive，执行sudo systemctl start docker - 验证连通性：终端中执行
docker version --format '{{.Server.Version}}'能输出版本号才算通过
安装 Docker 扩展时避开权限陷阱
VSCode 默认从官方 Marketplace 安装，但 Linux 用户容易因权限问题导致扩展无法读取 /var/run/docker.sock：
- 不要用
sudo code启动 VSCode（这会绕过用户环境，且极不安全） - 正确做法是将当前用户加入
docker组：sudo usermod -aG docker $USER，然后完全退出并重登系统 - Windows/macOS 通常无此问题，因 Docker Desktop 自带 socket 代理层
用 Docker 扩展真正做点事：快速调试容器内进程
扩展最有价值的场景不是“启动容器”，而是和 Dev Container 模式联动调试。例如你打开一个含 .devcontainer/devcontainer.json 的项目：
- 按
Ctrl+Shift+P（macOSCmd+Shift+P），输入Docker: Rebuild and Reopen in Container - 扩展会自动构建镜像、启动容器、挂载源码、转发端口，并在新窗口中加载 VSCode Server
- 此时断点调试、终端命令、扩展（如 Python、Go）全部运行在容器环境中，而非宿主机
- 注意：
devcontainer.json中的runArgs若含--network=host，可能和宿主机端口冲突，要手动改forwardPorts
扩展 UI 上显示的“Containers”列表只是 docker ps 的可视化，删掉它不会影响正在运行的服务；真要清理，还是得靠 docker stop 和 docker rm ——别被图形界面惯出依赖。
