如何解决VS Code远程SSH连接时“Failed to install VS Code server”错误

以下是几种经过验证的解决方法，按优先级尝试：

1. 清理远程服务器上的旧VS Code Server残留文件 #

远程服务器上的旧Server文件可能损坏或版本不兼容，直接删除后让VS Code重新安装：

# 删除稳定版Server文件
rm -rf ~/.vscode-server
# 如果是Insiders版本，额外执行
rm -rf ~/.vscode-server-insiders

删除后重新发起SSH连接，VS Code会自动重新下载并安装匹配版本的Server。

2. 检查远程服务器的权限与磁盘空间 #

• 目录权限检查：确保用户主目录权限正确，避免安装时写入失败：

  chmod 755 ~
  

• 磁盘空间检查：用以下命令确认用户主目录所在磁盘未被占满：

  df -h ~
  

如果磁盘已满，清理冗余文件后再尝试连接。

3. 手动安装匹配版本的VS Code Server #

如果自动下载失败，可手动指定版本安装：

1. 在本地VS Code中查看版本信息：打开「帮助」→「关于」，记录版本号（如1.85.1）和对应的提交哈希（如0ee08df0cf4527e40edc9aa28f4b5bd38bbff2b2）。
2. 登录远程服务器，执行以下命令替换为你的版本信息：

   # 创建对应版本的目录
   mkdir -p ~/.vscode-server/bin/<提交哈希>
   cd ~/.vscode-server/bin/<提交哈希>
   # 下载对应版本的Server包（替换<提交哈希>为你记录的内容）
   wget https://update.code.visualstudio.com/commit:<提交哈希>/server-linux-x64/stable
   # 解压包
   tar -xzf stable
   

3. 回到本地VS Code，重新发起SSH连接。

4. 降级Remote - SSH扩展 #

如果是近期扩展更新后出现的问题，尝试降级到之前可用的版本：

• 打开VS Code的扩展面板，找到「Remote - SSH」扩展。
• 点击扩展卡片右下角的齿轮图标，选择「安装另一个版本」。
• 选择一个之前能正常连接的版本，安装后重启VS Code再尝试连接。

5. 检查远程服务器的网络连通性 #

确保远程服务器能正常访问VS Code的更新服务器，可通过以下命令测试：

curl -I https://update.code.visualstudio.com

如果返回状态码为200或302，说明网络正常；否则需要检查服务器的出站防火墙或代理设置。

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