vscode 的 docker 扩展依赖本地 docker engine，需预先安装并启动 docker；用户须属 docker 组（linux）或以管理员运行 docker desktop（windows/macos），且 vscode 不可 root 启动；扩展功能如构建、运行、复制文件等均映射对应 cli 命令，但需手动刷新容器列表。
VSCode 本身不内置 Docker 运行时，但通过官方扩展 Docker（由 Microsoft 提供）可以高效管理镜像、容器、网络和卷，前提是本地已安装并运行 Docker Engine（dockerd）。没装 Docker CLI 或服务未启动，扩展会直接报错 Command 'Docker: List Images' resulted in an error (command 'docker.images.list' not found)。
安装 Docker 扩展前必须确认的三件事
VSCode 的 Docker 功能完全依赖宿主机的 Docker 环境，不是“在 VSCode 里跑 Docker”：
- 已安装 Docker Desktop（macOS/Windows）或
docker-ce+docker-cli（Linux），且docker version命令能正常输出客户端和服务端版本 - 当前用户属于
docker用户组（Linux）或以管理员身份运行 Docker Desktop（Windows/macOS）——否则扩展会提示 permission denied - VSCode 没有以 root 启动（Linux/macOS），否则可能因 socket 权限问题无法连接
/var/run/docker.sock
用 Docker 扩展快速构建并运行容器（不写 docker run 命令）
适合调试单服务应用，比如一个 Node.js API 或 Python Flask 服务。关键不是“点几下”，而是理解它背后调用的是什么命令：
- 右键
Dockerfile→Build Image...，输入 tag（如myapp:dev），等同于执行docker build -t myapp:dev . - 右键刚构建好的镜像 →
Run Interactive...，弹出表单填入Port mappings（如3000:3000）、Environment variables（如NODE_ENV=development），本质是生成并执行docker run -it -p 3000:3000 -e NODE_ENV=development myapp:dev - 容器启动后，右键容器 →
Attach Shell，自动打开集成终端并执行docker exec -it <container-id> /bin/sh</container-id>（若无/bin/sh则 fallback 到/bin/bash）
从容器中复制文件到本地，比 docker cp 更直观
开发中常需要把容器内日志、配置或生成的文件拉出来分析。扩展提供图形化入口，但行为严格对应 CLI：
- 右键运行中的容器 →
Copy File From Container...，输入容器内路径（如/app/logs/error.log），再选本地保存位置 - 该操作等价于
docker cp <container-id>:/app/logs/error.log ./error.log</container-id>，不支持通配符（*）或目录递归（需手动 tar 打包后再 copy） - 如果路径不存在或权限不足，VSCode 不会报详细错误，只显示 “Failed to copy file” —— 此时应切到终端手动执行
docker exec <container-id> ls -l /app/logs/</container-id>验证路径和权限
镜像体积大？用扩展查看层信息比 docker history 更易读
Docker 扩展在镜像详情页（右键镜像 → Inspect）里默认展示 Size 和 Created，但真正有用的是点击右上角 Layers 标签：
- 每层显示指令（
RUN apt-get update）、大小（124.5 MB）、创建时间，可直观定位臃肿层 - 对比
docker history myapp:dev输出：后者不显示层大小（除非加--human=false），且指令被截断，不易关联到 Dockerfile 行号 - 注意：
Layers视图不显示FROM基础镜像的层（如node:18-alpine的 5 层），只显示当前构建上下文新增的层
最常被忽略的是：Docker 扩展不会自动刷新容器列表——容器被 docker kill 或崩溃退出后，VSCode 侧边栏仍显示 “running”，必须手动右键容器 → Refresh 或按 Ctrl+Shift+P 输入 Docker: Refresh。这容易导致误操作，比如对已终止容器执行 Attach Shell，结果报错 No such container 却不知原因。
