VSCode 通过官方 Docker 扩展（ms-azuretools.vscode-docker）配合本地 Docker Engine 实现容器管理，依赖系统 PATH 中的 docker 命令，需确保 dockerd 正常运行、用户权限正确（如加入 docker 组）、VSCode 启动前已验证 docker info 可用，且不支持 podman。
VSCode 本身不内置 Docker 运行时，但通过官方 Docker 扩展 + 本地已安装的 dockerd（Docker Engine），可以实现容器发现、镜像构建、容器日志查看、终端直连等核心管理能力——前提是你的系统已正确安装并运行 Docker。
确认 Docker CLI 可被 VSCode 访问
VSCode 的 Docker 扩展依赖系统 PATH 中的 docker 命令。常见失败场景是：Docker Desktop 已启动，但终端能执行 docker ps，VSCode 却提示 “Docker daemon is not running”。
- Windows/macOS 用户：确保 Docker Desktop 启动后，勾选了 “Start Docker Desktop when you log in”，且未处于“手动启动”状态
- Linux 用户：检查是否将当前用户加入
docker用户组：sudo usermod -aG docker $USER
，然后完全退出并重登会话（仅重启终端不够） - VSCode 启动前，先在终端运行
docker info验证；若成功，再用该终端启动 VSCode：code .
安装并配置 Docker 扩展
扩展 ID 是 ms-azuretools.vscode-docker，由 Microsoft 官方维护。它不提供 Docker 引擎，只提供 UI 和命令封装。
- 在 VSCode 扩展市场搜索 “Docker”，认准发布者为 Microsoft，安装后无需额外配置即可识别本地
dockerCLI - 扩展默认监听
unix:///var/run/docker.sock（Linux/macOS）或named pipe: //./pipe/docker_engine（Windows），不可手动修改该路径——改了反而会断连 - 如果你使用
podman替代 Docker，此扩展不支持；需改用redhat.vscode-podman
从代码目录一键构建并运行容器
扩展会自动查找项目根目录下的 Dockerfile，但构建行为仍由 CLI 执行，VSCode 只做触发和展示。
- 右键点击
Dockerfile→ 选择 “Build Image…”，会弹出输入框让你填写镜像名（如myapp:latest），回车即执行docker build -t myapp:latest . - 构建成功后，在左侧 Docker 视图中展开 Images 节点，右键镜像 → “Run Interactive”，可传参如
-p 3000:3000 -e NODE_ENV=dev - 注意：如果
Dockerfile使用了多阶段构建（FROM golang:1.22 AS builder），扩展仍能识别并构建，但不会自动清理中间镜像——需手动运行docker builder prune
调试容器内进程（如 Node.js/Python）
VSCode 无法直接 attach 到任意容器进程，必须容器内已运行调试器，并暴露调试端口（如 Node 的 --inspect=0.0.0.0:9229）。
- 在
Dockerfile中添加调试启动命令，例如 Node.js：CMD ["node", "--inspect=0.0.0.0:9229", "server.js"]
- 运行容器时映射调试端口：
docker run -p 9229:9229 myapp（扩展的 “Run Interactive” 不支持传复杂参数，建议用终端手动运行） - 在 VSCode 中配置
.vscode/launch.json，使用attach类型，port设为 9229，address设为localhost—— 此时 VSCode 会连接宿主机的 9229 端口，再经 Docker 网络转发到容器内 - 别忘了在容器内安装
node_modules时保留devDependencies，否则ts-node或nodemon可能缺失
真正容易卡住的地方不是功能找不到，而是 Docker 守护进程与 VSCode 启动上下文之间的环境隔离——尤其在 WSL2、macOS Rosetta 或 Linux systemd user session 下，socket 文件路径或权限稍有偏差，整个扩展就变灰。与其反复重装扩展，不如先在终端里跑通 docker ps 和 docker build。
