Remote Explorer 需远程上下文激活才显示,依赖 SSH 配置正确、插件启用及平台识别精准;图标隐藏是设计逻辑,非 bug,须先建立连接或手动调出。

Remote Explorer 不是“点开就用”的面板,它只在远程上下文激活后才真正可用;没连过主机、没装对插件、没配对 SSH 配置文件,它就会彻底消失。
Remote Explorer 图标不显示?先确认远程上下文是否成立
图标默认隐藏,不是 bug,是设计逻辑:它只在你已处于远程会话(SSH / WSL / Container)或至少成功执行过一次 Remote-SSH: Connect to Host 后才会常驻侧边栏底部。
- 左下角状态栏没出现
SSH: user@host或WSL: Ubuntu——说明还没进入远程上下文,此时 Remote Explorer 不会自动出现 - 按
Ctrl+Shift+P(Win/Linux)或Cmd+Shift+P(Mac),输入并运行View: Show Remote Explorer可临时唤出,但下次重启 VSCode 仍会消失,除非你已建立连接 - 插件未启用也会导致视图不可见:检查
ms-vscode-remote.remote-ssh是否已启用(不是仅安装),禁用后必须重启 VSCode 才生效
SSH 主机列表为空?配置不在界面上,在 ~/.ssh/config 里
Remote Explorer 的 SSH TARGETS 区域不提供图形化增删主机功能,它只是读取本地 SSH 配置文件的只读视图。
- 新增主机必须手动编辑:
~/.ssh/config(Linux/macOS)或%USERPROFILE%\.ssh\config(Windows) - 每段以
Host开头,例如:Host my-vps HostName 192.168.1.100 User ubuntu Port 2222 IdentityFile ~/.ssh/id_rsa
- 改完保存后,需在 Remote Explorer 顶部点击刷新按钮(或右键空白处选
Refresh),否则新条目不会出现 -
remote.SSH.configFile设置项可覆盖默认路径,但若指向一个不存在或格式错误的文件,主机列表将直接为空
点连接后卡在 “Setting up SSH Host”?问题不在 Remote Explorer,而在 SSH 层
这个提示本质是 VSCode 在调用系统 ssh 命令时阻塞了,和 Remote Explorer 界面无关。排查必须下沉到终端级验证。
- 先在本地终端运行:
ssh -T -o ConnectTimeout=5 my-vps(把my-vps换成你的Host别名),看能否直连;失败就别指望 VSCode 能绕过去 - 私钥权限太松(如
644)会导致 OpenSSH 拒绝使用:Linux/macOS 下运行chmod 600 ~/.ssh/id_rsa;Windows 上注意 OpenSSH 默认不认.ppk,得转成 OpenSSH 格式 -
remote.SSH.path若被手动设为非标准ssh可执行文件(比如 MinGW 自带的老版本),会静默失败;清空该设置让 VSCode 回退到系统默认更稳妥
为什么连上后打开文件夹还要输密码?可能缺了 remote.SSH.remotePlatform
VSCode 远程连接后首次打开文件夹时弹密码框,常见于目标主机平台识别失败,尤其在非标准 Linux 发行版或 ARM 服务器上。
- 在 VSCode 用户设置(
settings.json)中添加:"remote.SSH.remotePlatform": { "my-vps": "linux" }其中my-vps必须和~/.ssh/config中的Host名完全一致 - 不配这项,VSCode 会在连接时弹出平台选择框,选
linux也能临时绕过,但每次新建窗口都会再问一次 - 如果目标其实是 WSL2 或容器,该项应分别设为
wsl或linux,填错会导致终端无法启动、文件监视失效等隐性问题
Remote Explorer 真正难的不是“怎么点”,而是它背后依赖的三层链路:SSH 配置文件语法正确性、本地 OpenSSH 行为一致性、VSCode 对远程平台的识别精度——任一环出问题,界面都只会安静地不响应,不会报错。


















