解决 VS Code Remote-SSH “无法安装 VS Code 服务器“ 错误的完整指南

当使用 VS Code 的 Remote-SSH 扩展连接远程服务器时，遇到 “无法安装 VS Code 服务器” 错误是常见问题。本文将系统化分析问题原因并提供多种解决方案。

---

问题根源分析

错误日志中关键信息：

[UnpackFailed]: Error: UnpackFailed (无法安装 VS Code 服务器)
tar: Error is not recoverable: exiting now

通常由以下原因导致：

1. 磁盘空间不足（90% 的常见原因）
2. 远程目录权限错误
3. 服务器依赖库缺失
4. 网络连接问题
5. VS Code 扩展或缓存异常

---

系统化解决方案

方案 1：检查远程服务器磁盘空间（首要步骤）

# 检查磁盘使用情况
df -h

# 检查用户目录大小
du -sh ~

处理建议：

• 确保用户目录有至少 1GB 可用空间
• 清理缓存文件：

  rm -rf ~/.cache/*
  sudo journalctl --vacuum-size=200M
  

方案 2：修复远程目录权限