遇到 VSCode 远程 SSH 连接超时或 Lost Connection 报错，最直接的处理方向是检查本地网络稳定性并调整 SSH 保持活跃配置，多数情况下能通过修改本地 SSH 配置文件解决。

命令速用版

如果希望快速尝试修复，可以在终端执行以下命令检查 connectivity 或清理远程进程。

1. 测试原生 SSH 连接 verbose 模式：

ssh -v user@hostname

2. 确认并清理远程 VSCode Server 进程（需在能 SSH 登录的前提下）：

ps -ef | grep vscode-server
pkill -f vscode-server

3. 本地 SSH 配置追加保持活跃参数：

注意：Windows CMD/PowerShell 不支持 Linux echo 语法，建议手动编辑文件。

# Linux/Mac/Git Bash
echo -e "Host *\n    ServerAliveInterval 60\n    ServerAliveCountMax 3" >> ~/.ssh/config

# Windows PowerShell (需确认路径权限)
Add-Content -Path "$HOME\.ssh\config" -Value "`nHost *`n    ServerAliveInterval 60`n    ServerAliveCountMax 3"

为什么会这样

VSCode 远程开发依赖 SSH 隧道维持长连接。当本地网络出现波动、NAT 设备超时回收端口，或者远程服务器的 SSH 守护进程配置了较短的空闲超时时间，连接就会中断。

另外，VSCode 会在远程服务器安装一个 Server 端程序用于通信。如果该进程因为资源不足或异常退出而僵死，VSCode 客户端再次尝试连接时可能会复用旧会话或握手失败，从而报出 Lost Connection 或 Timeout。

根据社区反馈，网络 keepalive 设置缺失和远程进程残留是最常见的两个诱因。

分步处理

第一步：检查基础网络连通性

先不要用 VSCode，直接在终端使用 SSH 命令连接。如果原生 SSH 也频繁断开，说明是网络或服务器 SSH 配置问题，而非 VSCode 插件问题。

检查点：执行 ssh user@hostname 后保持空闲，观察是否会在特定时间后断开。留意报错关键字如 Connection reset by peer 或 Connection timed out。

第二步：配置 SSH 保持活跃参数

在本地电脑的 SSH 配置文件中添加心跳检测。

• Linux/Mac 路径：~/.ssh/config
• Windows 路径：C:\Users\用户名\.ssh\config

添加以下内容（注意检查是否已存在类似配置，避免重复）：

Host 你的主机别名或 *
    ServerAliveInterval 60
    ServerAliveCountMax 3

注意：ServerAliveInterval 单位为秒，表示每 60 秒发送一次空包保活。Host * 表示对所有 SSH 连接生效，若只想针对特定服务器，请将 * 替换为具体的 Host 别名。

第三步：清理远程 VSCode Server

如果原生 SSH 稳定但 VSCode 连不上，可能是远程残留进程干扰。通过原生 SSH 登录远程服务器，执行：

# 1. 先确认进程是否存在
ps -ef | grep vscode-server

# 2. 清理进程及目录
pkill -f vscode-server
rm -rf ~/.vscode-server

回滚提醒：删除 .vscode-server 目录会导致下次连接时重新下载服务端程序，请确保远程网络通畅。

第四步：更新或重装远程插件

在 VSCode 扩展商店中，确保 "Remote - SSH" 插件为最新版本。偶尔插件版本与 VSCode 主程序不匹配也会导致握手失败。

怎么验证是否生效

1. 打开 VSCode 输出面板（View -> Output），选择 "Remote - SSH" 通道。

2. 尝试连接远程主机，观察日志是否不再出现 "Connection reset" 或 "Timeout" 字样。

3. 连接成功后，保持窗口空闲 10 分钟以上，确认不会自动断开。

4. 若仍失败，查看日志中是否有 Failed to connect to remote extension host 或 Handshake failed 等具体错误。

常见坑

1. 配置文件语法错误与重复

SSH config 文件对缩进敏感，通常使用空格或 Tab 均可，但键值对之间需有空格。如果配置错误，可能导致所有 SSH 连接失败。追加配置前请搜索文件是否已存在 ServerAliveInterval，避免冲突。

2. Windows 命令兼容性

Windows CMD 或 PowerShell 默认不支持 Linux 风格的 echo -e 命令。建议直接使用记事本或 VSCode 打开配置文件手动编辑，或使用 PowerShell 的 Add-Content 命令。

3. 远程服务器权限问题

清理远程目录时，确保当前登录用户有权限删除 ~/.vscode-server。如果是多用户共用服务器，误删可能影响他人环境。

4. 防火墙干扰

部分公司网络或云服务器安全组会拦截长连接的空包。如果调整 keepalive 后仍无效，需检查中间网络设备是否允许该流量。

参考来源

• Microsoft Learn, "Troubleshooting SSH connections", https://code.visualstudio.com/docs/remote/troubleshooting
• OpenSSH Project, "ssh_config man page", https://man.openbsd.org/ssh_config.5