VSCode 中需安装 Docker 插件并确保 Docker Desktop 正常运行,才能通过侧边栏可视化管理镜像与容器;若连接远程主机,需在 settings.json 中配置 DOCKER_HOST 环境变量。

如果您在使用 VSCode 进行容器化开发,但无法通过图形界面查看、启动或删除本地 Docker 镜像与容器,则可能是 Docker 插件未正确启用或配置。以下是实现可视化管理镜像和容器的具体操作步骤:
本文运行环境:MacBook Air M2,macOS Sequoia。
一、安装并启用 Docker 插件
VSCode 本身不内置 Docker 管理功能,需通过官方维护的 Docker 扩展提供侧边栏集成视图。该插件依赖本地 Docker CLI 可执行文件及后台守护进程正常运行。
1、打开 VSCode,点击左侧活动栏最下方的扩展图标(四个方块组成的图标)。
2、在扩展市场搜索框中输入 Docker,找到由 Microsoft 发布、图标为鲸鱼图案的官方插件。
3、点击“安装”按钮,等待下载完成,随后点击“重新加载”使插件生效。
4、重启 VSCode 后,左侧活动栏将出现一个鲸鱼图标,点击即可打开 Docker 视图。
二、验证 Docker CLI 与后台服务连通性
插件界面为空或显示“Cannot connect to the Docker daemon”提示,通常表示 VSCode 无法调用宿主机的 Docker 守护进程。需确认 CLI 可访问且 Docker Desktop(或 dockerd)正在运行。
1、打开终端,执行命令 docker version,检查是否输出客户端和服务端版本信息。
2、若提示“Cannot connect to the Docker daemon”,请启动 Docker Desktop 应用程序。
3、在 Docker Desktop 设置中,确保已勾选 Start Docker Desktop when you log in 和 Use the new Virtualization framework(macOS M 系列芯片必需)。
4、返回 VSCode,右键点击 Docker 侧边栏空白处,选择 Refresh。
三、使用侧边栏执行镜像与容器操作
Docker 插件将本地镜像、运行中/已停止容器、构建上下文、卷与网络等资源以树形结构组织,支持鼠标悬停提示与右键快捷菜单,无需记忆 CLI 命令即可完成核心管理任务。
1、在 Docker 侧边栏中展开 Images 节点,查看所有本地镜像,右键某镜像可选择 Pull latest、Remove 或 Build Image。
2、展开 Containers 节点,区分 Running 与 Stopped 分组,右键容器可执行 Start、Stop、Restart、Remove 或 Attach Visual Studio Code。
3、点击容器右侧的终端图标,可直接打开该容器内 Bash 或 sh 会话。
四、配置远程 Docker 主机连接
当开发环境与 Docker 守护进程分离(如使用远程 Linux 服务器或 WSL2 中的 dockerd),需通过 TCP 或 SSH 协议重定向插件连接目标主机,而非默认的 Unix socket。
1、在 VSCode 设置中搜索 docker environment,点击“Edit in settings.json”。
2、在 settings.json 文件中添加配置项:"docker.environment": {"DOCKER_HOST": "ssh://user@192.168.1.100"},其中 IP 替换为目标服务器地址。
3、确保目标主机已启用 SSH 服务,且用户具备无密码执行 docker 命令的权限(例如加入 docker 用户组并配置 sudo 免密)。
4、保存文件后,右键 Docker 侧边栏空白区域,选择 Refresh,插件将尝试建立远程连接。










