vscode远程连接掉线后无法重连，八成是本地缓存与远程残留进程/文件不一致所致；需同步清理本地%userprofile%\.vscode-server（windows）或~/.vscode-server（macos/linux）及远程~/.vscode-server目录，并执行remote-ssh: kill vs code server on host、彻底退出vscode后重连。
VSCode远程连接掉线后无法重新连接，八成是本地缓存和远程残留进程/文件不一致导致的，不是网络或账号问题。直接清理两处关键位置就能解决，不用重装插件、不用改 SSH 配置。
Remote-SSH 插件卡在 “Reconnect” 按钮不响应
点击“Reconnect”没反应，或弹窗后一直转圈，说明 Remote-SSH 扩展内部状态已僵死，它不会自动清理旧连接上下文。
- 先按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入并运行Remote-SSH: Kill VS Code Server on Host，选目标主机——这会清理远程~/.vscode-server下的活跃进程和临时 socket - 关闭当前 VSCode 窗口，**不要点“Keep Window”**，必须完全退出进程，否则本地缓存仍被锁定
- 重启 VSCode，再用
Remote-SSH: Connect to Host重连，让插件从头走完整流程
本地 .vscode-server 缓存目录必须清空
VSCode 1.86+ 对服务端二进制签名校验更严格，旧版残留会导致新客户端拒绝启动 server，报错常表现为 Cannot read property 'length' of undefined 或直接卡在 Installing VS Code Server...。
- Windows：删掉
%USERPROFILE%\.vscode-server（注意不是.vscode） - macOS/Linux：删掉
~/.vscode-server - 别只删
bin/current或某个子目录——要整个目录一并删除，否则下次连接仍会复用损坏元数据
远程 ~/.vscode-server 不是删了就完事
手动 rm -rf ~/.vscode-server 后目录确实会重现，但如果不处理残留进程和历史版本，重连仍可能失败或启动极慢。
- 先检查有没有僵尸进程：
ps aux | grep -E "(vscode-server|code-server)" | grep -v grep - 有就杀干净：
pkill -f "vscode-server"（或kill -9对应 PID） - 再删目录：
rm -rf ~/.vscode-server - 如果磁盘空间紧张，可额外清理历史 commit：
find ~/.vscode-server/bin -mindepth 1 -maxdepth 1 -not -name "current" -type d -exec rm -rf {} +
为什么清理后首次连接仍慢？
因为 VSCode 要重新下载对应 commit 的 code-server 二进制并解压，国内直连 update.code.visualstudio.com 常超时或 404。
- 临时生效：在 VSCode 的 Remote-SSH 设置里，给
remote.SSH.env加一条："VSCODE_AGENT_FOLDER": "https://npmmirror.com/mirrors/code-server"（注意路径需匹配你用的 VS Code 版本号） - 更稳做法：手动下载
vscode-server-linux-x64.tar.gz（选对系统架构），上传到~/.vscode-server/bin/<commit-id>/<commit-id></commit-id></commit-id>，再chmod +x ~/.vscode-server/bin/*/bin/code-server - 别把 tar.gz 直接解压到
~/.vscode-server根目录——结构错位会导致Cannot find module 'vs/server/main'
真正容易被忽略的是：本地和远程缓存必须同步清理，缺一不可；而残留进程不杀，.vscode-server 就算删了也会被旧进程继续写入损坏文件。
