Docker扩展在VSCode中集成镜像、容器、Compose服务管理,通过图形化界面简化构建、运行、调试流程,支持远程仓库连接与开发环境隔离,提升本地容器化开发效率。

VSCode 的 Docker 扩展极大简化了本地容器化开发流程,让你在编辑器内直接管理镜像、容器、Docker Compose 服务和 Registry。以下是该扩展的完整使用指南,帮助你高效上手并掌握核心功能。
Docker 扩展安装与环境准备
在开始前,确保你的系统已安装以下组件:
- Docker Desktop(Windows/macOS)或 Docker Engine(Linux)
- Visual Studio Code
- Docker 扩展:打开 VSCode,进入扩展商店搜索 “Docker”,选择由 Microsoft 官方发布的 “Docker” 扩展并安装
安装完成后,重启 VSCode。左侧活动栏会出现一个船型图标(Docker 图标),点击即可打开 Docker 面板。
界面概览与核心功能
Docker 扩展面板分为多个区域,便于快速操作:
- Images:查看本地所有镜像,支持构建、删除、打标签、推送等操作
- Containers:列出正在运行和已停止的容器,可启动、停止、日志查看、进入终端
- Volumes:管理 Docker 卷,查看挂载路径和使用情况
- Networks:查看自定义和默认网络配置
- Registries:连接远程镜像仓库(如 Docker Hub、Azure Container Registry)进行拉取和推送
- Docker Compose:自动识别项目中的 docker-compose.yml 文件,支持一键启动/停止服务
快速构建与运行容器
假设你有一个简单的 Node.js 或 Python 项目,可以通过以下步骤快速容器化:
- 右键项目根目录,选择 “Add Docker Files to Workspace”
- 根据提示选择应用类型(如 Node.js、Python、None)
- 选择是否启用 Docker Compose(推荐用于多服务)
- 指定应用端口(如 3000)
VSCode 会自动生成 Dockerfile 和可选的 docker-compose.yml。
生成后,在 Docker 面板中右键对应镜像名称,选择 “Build Image” 即可构建。构建成功后,右键镜像选择 “Run Interactive” 启动容器。
调试容器内应用(以 Node.js 为例)
要实现断点调试,需配置开发专用的 Dockerfile 和 devcontainer.json:
- 右键 Docker 扩展面板 → “Add Development Container Configuration Files”
- 选择预设环境(如 Node.js + TypeScript)
- VSCode 会在 .devcontainer 目录下生成 Dockerfile 和 devcontainer.json
按下 F1,输入 “Reopen in Container”,VSCode 将自动构建镜像并把整个开发环境迁入容器中。此时所有终端、插件、文件操作都在容器内执行,实现真正的隔离开发。
常用右键操作快捷方式
Docker 面板中的每一项都支持上下文菜单操作:
- 容器:查看日志、打开终端、端口转发、复制 ID
- 镜像:构建、推送、删除、创建容器
- Docker Compose 服务:启动全部、停止全部、重启单个服务
- Registry 镜像:拉取指定 tag
例如:右键容器 → “Attach Shell” 可直接进入 bash;右键镜像 → “Push” 推送至 Docker Hub(需先登录)。
连接远程 Registry
在 Registries 节点下,右键 “Add Registry Connection”,可添加:
- Docker Hub(个人或组织)
- Azure Container Registry
- Amazon ECR
- 私有 Registry(需提供 URL 和认证信息)
连接成功后,可浏览远程镜像、拉取特定版本,或将本地镜像推送到指定仓库。
实用技巧与最佳实践
- 使用 .dockerignore 排除不必要的文件(类似 .gitignore),加快构建速度
- 通过 docker-compose.yml 定义多服务依赖(如 Web + DB),利用 VSCode 一键启停
- 结合 Settings Sync,同步 Docker 扩展配置到其他设备
- 在 devcontainer.json 中预装工具(如 git、curl、数据库客户端),提升开发效率
- 使用 “Docker: Use Current Context” 命令切换 Kubernetes 或远程 Docker 主机
基本上就这些。Docker 扩展将复杂的 CLI 操作图形化,尤其适合初学者和需要快速验证容器行为的开发者。配合 Dev Containers 功能,还能实现团队开发环境一致性,减少“在我机器上是好的”问题。










