VS Code Remote SSH 常见问题修复指南

1. 连接成功但卡住 / 日志报错 "Failed to parse remote port"

现象

• 左下角状态栏一直转圈，最后连接超时。
• 查看 VS Code 的 Output 日志，出现 listeningOn==== (后面为空)，或者报错 Failed to parse remote port。

日志示例：

[15:22:08.142] Received install output: 
listeningOn====
...
[15:22:08.143] Failed to parse remote port from server output

原因

服务端 VS Code Server 进程死锁或者文件损坏，导致无法正确启动并监听端口（常见于容器非正常关闭后）。

解决方案

需要"清理现场"。请在 网页终端 (Web Terminal) 执行以下命令：

# 1. 杀掉卡死的残留进程（强制清理）
pkill -f vscode-server
pkill -f vscode-ipc
pkill -f node

# 2. 稍后在本地 VS Code 中按 F1 -> "Developer: Reload Window" 刷新重连

---

2. 重装 Server 时删除文件夹卡死

现象

如果方案 1 无效，通常需要删除 ~/.vscode-server 目录重装。但是执行 rm -rf ~/.vscode-server 后，终端卡住数分钟没有反应。

原因

云环境通常使用网络存储（NFS/Ceph）。.vscode-server 包含成千上万个小文件（node_modules 等），网络存储在处理大量小文件的删除操作时通信开销巨大，速度极慢。

🚀 极速解决方案（改名法）

不要傻等删除，直接改名（Move），系统瞬间完成：

# 在网页终端执行：
mv ~/.vscode-server ~/.vscode-server_backup_failed

执行完后，立刻回到本地 VS Code 点击连接。VS Code 会发现目录不存在，会立即下载全新的服务端，问题瞬间解决！改名后的垃圾文件夹可以不用管，等容器重置会自动消失。