问题现象描述
典型表现
当使用 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...
