Remote Explorer 可统一管理 SSH 主机、Docker 容器和 WSL 发行版:启用视图后,通过 ~/.ssh/config 添加 SSH 主机,Attach 到运行中容器,Windows 下自动识别 WSL;还可批量配置默认扩展等连接参数。

如果您在使用 VSCode 进行远程开发时发现多个 SSH 主机、容器或 WSL 实例分散在不同位置,难以快速切换和维护,则可能是由于 Remote Explorer 视图未被正确配置或未充分利用。以下是统一管理所有远程连接的具体操作步骤:
本文运行环境:MacBook Pro,macOS Sequoia。
一、启用并定位 Remote Explorer 视图
Remote Explorer 是 VSCode 内置的侧边栏视图,专用于集中展示和操作所有远程目标(SSH 主机、Docker 容器、WSL 发行版)。启用该视图是实现统一管理的前提,它不依赖额外插件,但需确保已安装 Remote Development 扩展包。
1、点击左侧活动栏最下方的“远程资源管理器”图标(图标为两个相互连接的圆环);
2、若该图标未显示,按 Cmd+Shift+P 打开命令面板,输入 View: Show Remote Explorer 并回车;
3、确认右下角状态栏中出现远程连接指示器(如 SSH: user@host 或 WSL: Ubuntu)。
二、添加 SSH 主机连接配置
通过编辑 ~/.ssh/config 文件,可将常用远程服务器定义为命名主机,Remote Explorer 将自动读取并列出这些条目,无需每次手动输入地址与端口。
1、打开终端,执行 nano ~/.ssh/config;
2、插入如下格式的配置块(每段以 Host 开头,后接自定义别名):
Host my-server
HostName 192.168.1.100
User deploy
Port 2222
3、保存退出后,在 Remote Explorer 中点击“SSH TARGETS”下的刷新按钮,my-server 将立即出现在列表中。
三、连接并挂载 Docker 容器
Remote Explorer 支持直接连接正在运行的 Docker 容器,将其作为开发环境挂载,适用于调试微服务或测试镜像行为。该功能依赖本地 Docker CLI 可访问且 daemon 正常运行。
1、确保 Docker Desktop 已启动,并在终端中执行 docker ps 可见活跃容器;
2、在 Remote Explorer 的“CONTAINERS”部分,点击右上角 … 菜单,选择 Attach to Running Container;
3、从下拉列表中选择目标容器(如 nginx:latest 对应的 ID),VSCode 将自动安装容器内 VS Code Server 并加载工作区。
四、集成 WSL 发行版为远程目标
在 Windows 系统中,WSL2 发行版默认被 Remote Explorer 自动识别为独立远程环境。macOS 用户无法使用此功能,但可通过 Multipass 或虚拟机模拟类似场景;此处操作仅适用于 Windows 环境下的 WSL 集成。
1、在 Windows 上安装 WSL2 并至少一个发行版(如 Ubuntu-22.04);
2、启动 VSCode 桌面版(非 Web 版),Remote Explorer 的“WSL”区域将自动列出所有已安装发行版;
3、点击对应发行版名称(如 Ubuntu-22.04),VSCode 将在该发行版文件系统中打开新窗口,并复用其 shell 与 PATH。
五、批量管理远程连接设置
Remote Explorer 允许用户对多个远程目标进行统一配置,包括默认扩展安装策略、文件关联规则及连接超时参数。这些设置存储于用户级 settings.json 中,影响所有远程会话。
1、在任意远程连接窗口中,按 Cmd+, 打开设置界面;
2、搜索 remote.SSH.defaultExtensions,点击“在 settings.json 中编辑”;
3、添加数组项,例如:["ms-python.python", "esbenp.prettier-vscode"],保存后新建立的 SSH 连接将自动安装这些扩展。










