VS Code 的 Docker 扩展仅提供管理界面，依赖本地 Docker CLI 和 daemon；需先安装 Docker Desktop（或 Linux 的 dockerd），验证 docker version 和 docker run --rm hello-world 成功，Linux 用户还需加入 docker 组；扩展不自动识别项目，须手动触发操作；Dev Containers（devcontainer.json）比右键“Run in Container”更可靠，需配置 forwardPorts 和 customizations 才能正确调试。
VS Code 的 Docker 扩展本身不运行容器，它只是个管理界面；真正启动、调试、构建容器靠的是本地已安装的 docker CLI 和后台运行的 Docker daemon。没装好 Docker Desktop（或 Linux 上的 dockerd），扩展点开就是空的。
确认 Docker CLI 可用且权限正常
扩展依赖命令行工具，不是“装了扩展就自动有 Docker”。必须先在终端里验证：
- 运行
docker version—— 要同时看到 Client 和 Server 信息，Server 部分不能报Cannot connect to the Docker daemon - 运行
docker run --rm hello-world—— 确保能拉镜像并输出成功消息 - Linux 用户注意：如果提示
Permission denied，需把当前用户加入docker组：sudo usermod -aG docker $USER，然后重新登录终端
安装 Docker 扩展后要手动关联到项目
扩展不会自动识别你的项目是否该用 Docker。它只响应你主动触发的操作，比如右键文件夹或点击资源管理器里的 Docker 视图。常见误操作：
- 打开一个空文件夹 → 扩展显示“no dockerfiles found” → 这是正常的，它不猜你有没有打算用 Docker
- 已有
Dockerfile但没出现在工作区根目录 → 扩展默认只扫描根目录下的Dockerfile，不递归查找子目录 - 想用
docker-compose.yml启动服务 → 必须右键该文件，选 “Compose Up”，而不是点顶部的“+”按钮
调试容器时，devcontainer.json 比直接 run 更可靠
单纯用扩展右键 “Run in Container” 只是快速启一个带 VS Code Server 的容器，适合试玩；真做开发建议用 Dev Containers：
- 在项目根目录建
.devcontainer/devcontainer.json，明确指定image或dockerfile路径 - 配置
forwardPorts（如[3000, 5432]）才能让宿主机访问容器内服务 - 加
"customizations": { "vscode": { "extensions": ["ms-python.python"] } }可预装插件，避免每次重连都手动装 - 首次运行按
Ctrl+Shift+P→ 输入 “Dev Containers: Reopen in Container”，不是 “Docker: Run…”
很多人卡在容器起来但端口打不开、或者调试器连不上 Python/Node 进程——问题往往出在 devcontainer.json 没配 forwardPorts 或容器内服务没监听 0.0.0.0；扩展本身不改你的应用逻辑，它只负责端口映射和 VS Code 连接通道。
