VS Code Remote-SSH扩展重新认证后无法连接远程目录求助

临时修复方案（已验证有效） #

• 通过终端SSH连接到远程Linux主机，执行命令彻底删除远程VS Code服务目录：

  rm -rf ~/.vscode-server/
  

• 关闭VS Code中当前的Remote-SSH会话，重新发起连接，此时扩展会自动部署适配本地VS Code版本的远程服务，即可正常打开远程目录。

修复因修改设置导致的完全无法连接问题 #

若修改过以下Remote-SSH相关设置后出现连接失败，需重置为默认值：

• 打开VS Code设置（快捷键Ctrl+,），搜索并重置以下设置：
  • Remote: Download Extensions Locally
  • Remote SSH: Local Server Download
  • Remote SSH: Server Install Path
• 重置完成后重启VS Code，再尝试远程连接。

问题原因分析 #

VS Code Remote-SSH会校验远程主机.vscode-server目录内的服务版本与本地VS Code版本是否匹配，当目录存在损坏文件、版本不兼容，或扩展尝试重装服务时与旧文件产生冲突，就会触发认证循环、重连失败的问题。删除该目录后，扩展会重新下载干净的适配版本服务，从而解决冲突。

预防建议 #

• 尽量保持本地VS Code和Remote-SSH扩展为最新稳定版，减少版本兼容问题
• 非必要不要修改Remote-SSH的核心路径类设置，默认配置已适配绝大多数场景
• 配置SSH密钥认证替代密码认证，既提升连接效率，也能降低认证环节的冲突概率（生成本地密钥后，将公钥添加到远程主机~/.ssh/authorized_keys文件中）

内容的提问来源于stack exchange，提问作者Levi Condren