Remote Explorer 侧边栏不显示需先连接远程主机或手动激活,检查状态栏标识、插件启用状态及SSH配置;编辑主机需修改~/.ssh/config文件并刷新;连接失败应排查SSH密钥权限、网络连通性及remote.SSH.path设置。

Remote Explorer 侧边栏不显示怎么办
VSCode 的 Remote Explorer 视图默认不自动打开,也不是装了 Remote-SSH 就一定可见——它依赖当前工作区是否处于远程上下文,或用户手动激活。
- 如果没连过任何远程主机,
Remote Explorer默认隐藏;先用Ctrl+Shift+P(Win/Linux)或Cmd+Shift+P(Mac)调出命令面板,输入并执行Remote-SSH: Connect to Host...,连上一次后,侧边栏图标才会常驻 - 已连接但图标仍不出现?检查左下角状态栏:如果有
SSH: xxx或Dev Container标识,说明已在远程会话中,此时点击侧边栏最下方的远程图标(两个重叠的屏幕图标)即可唤出Remote Explorer - 插件未启用也会导致视图缺失:确认
ms-vscode-remote.remote-ssh(或对应 remote 插件)已启用,禁用后重启 VSCode 不会自动恢复该视图
Remote Explorer 里显示的“SSH Targets”怎么编辑
Remote Explorer 中列出的主机来自 ~/.ssh/config 和 VSCode 自己的 settings.json 里的 remote.SSH.configFile 配置项,不是靠界面点几下就能增删的。
- 新增主机必须直接编辑 SSH 配置文件:
~/.ssh/config(Linux/macOS)或%USERPROFILE%\.ssh\config(Windows),每段以Host开头,例如:
Host my-server
HostName 192.168.1.100
User ubuntu
IdentityFile ~/.ssh/id_rsa
Remote Explorer 顶部点刷新按钮(或右键空白处选 Refresh),新条目才会出现~/.ssh/config:你在 Remote Explorer 里右键某个主机选 Edit Configuration File,只是打开该文件供你手动编辑,不是图形化配置工具点连接后卡在“Setting up SSH Host”或报错“Could not establish connection to…”
这不是 Remote Explorer 本身的问题,而是底层 SSH 连接失败,常见于密钥、权限或网络配置环节。
- 先确认本地能通:终端里运行
ssh -T -o ConnectTimeout=5 my-server(把my-server换成你的 Host 别名),看是否直连成功;失败就别指望 VSCode 能绕过去 - 私钥权限太松会拒绝连接:Linux/macOS 下运行
chmod 600 ~/.ssh/id_rsa,Windows 上注意 OpenSSH 默认不读取.ppk文件,得转成openssh格式 - VSCode 默认走系统 SSH,但如果你改过
remote.SSH.path设置,指向了一个不兼容的ssh可执行文件(比如旧版或 MinGW 版),也会静默失败;清空该设置让其回退到默认行为更稳妥
为什么 Remote Explorer 显示多个重复主机或旧主机删不掉
它会同时读取多个来源:系统 ~/.ssh/config、VSCode 工作区 .vscode/settings.json 中定义的 remote.SSH.hosts、以及曾经连接过的临时缓存(存在 ~/.vscode-server/data/Machine/ 下的 JSON 文件里)。
- 重复显示通常是因为同一台机器在
~/.ssh/config里被定义了多个Host别名,或者在不同工作区设置了不同的remote.SSH.hosts - 删不掉的“幽灵主机”大概率是缓存残留:关闭所有 VSCode 窗口,删除
~/.vscode-server/data/Machine/sshHosts.json(路径可能因版本略有差异),再重启 - 想彻底隔离配置?避免在全局
settings.json里写死remote.SSH.hosts,改用项目级.vscode/settings.json,这样换项目时不会互相污染
Remote Explorer 本质是个视图代理,它不存连接状态、不管理密钥、也不参与认证流程——所有“连接逻辑”都在 SSH 客户端和 VSCode Remote Server 之间完成。界面点来点去解决不了握手失败,真正要盯的是终端里那行 ssh 命令能不能跑通。










