问题现象描述
典型表现
当使用 VS Code 的 Remote-SSH 功能连接远程服务器时:
- 成功输入密码后,VS Code 并未正常连接服务器;
- 系统反复弹出'请输入 SSH 密码'的提示窗口;
- 即使密码无误,连接始终无法建立;
- Terminal 中可能看到
"Retrying after error: Connection refused"或"Permission denied"之类的提示; - 有时会自动执行安装 VS Code Server 的命令,但无反应或失败。
常见误区
- 反复重启 VS Code;
- 更换网络环境;
- 再三确认 SSH 密码是否输入正确;
- 在
~/.ssh/config中重新配置主机信息; - 尝试通过命令行使用
ssh user@host连接远程主机,结果显示一切正常。
但令人困惑的是,即便通过终端可以正常使用 SSH 登录,Remote-SSH 插件却依然连接失败。
原因分析
该问题的根本原因通常并不在于 SSH 配置错误或网络异常,而是出现在 VS Code 在服务器上部署的 vscode-server 出现异常或损坏。
Remote-SSH 插件在首次连接服务器时,会自动将一个小型的 vscode-server 程序上传至远程主机的 ~/.vscode-server 目录中,并通过该程序建立编辑器与远程主机之间的通信。
当这个 vscode-server 出现以下情况时就可能导致问题:
- 安装过程中被中断;
- 升级 VS Code 后版本不一致;
.vscode-server目录权限错误或文件损坏;- 残留的临时文件引起冲突;
- 磁盘空间不足或远程主机资源紧张。
解决方案
清除服务器上的 vscode-server
可以通过清除服务器上的 .vscode-server 目录来强制 VS Code 在下次连接时重新部署该服务。操作步骤如下:
第一步:登录远程服务器(如果你有办法…)
第二步:删除 .vscode-server 目录
rm -rf ~/.vscode-server
注意:如果使用的是 VS Code Insiders,则目录名可能为
~/.vscode-server-insiders;也有使用的是~/.vscode-remote,需根据具体情况处理。
第三步:重新连接 VS Code Remote-SSH
重新在 VS Code 中打开命令面板(Ctrl + Shift + P),执行:
Remote-SSH: Connect to Host...
选择目标主机,系统将重新部署 VS Code Server,并建立新的连接。
使用 Remote-SSH 清理命令
如果你希望使用 GUI 操作,也可以执行:
Remote-SSH: Kill VS Code Server on Host...
然后选择对应的主机。该命令会尝试远程执行清理任务,终止正在运行的 server 实例并删除缓存目录。
然而在某些场景中,该命令无法完全清理干净,此时建议回到方案一手动删除。
验证连接
删除后再次连接时,VS Code 应该会提示:
Installing VS Code Server on remote...


