VSCode Remote-SSH 本身不支持自动重连，所谓“自动重连”实为 SSH 层保活机制维持连接未断所致；真正起效的是 ~/.ssh/config 中的 ServerAliveInterval、ServerAliveCountMax 和 TCPKeepAlive yes 配置，且服务端 /etc/ssh/sshd_config 必须同步启用 ClientAliveInterval 和 ClientAliveCountMax，否则保活包会被丢弃。
VSCode Remote-SSH 本身不支持自动重连，所谓“自动重连”只是错觉——真正起作用的是 SSH 层的保活机制。掉线问题 90% 出在 ServerAliveInterval 和 ClientAliveInterval 配置缺失或不匹配。
为什么 remote.SSH.keepAlive 设置无效
这个配置只控制 VSCode 自身控制通道（比如命令面板、设置同步）的保活，对终端、端口转发、文件监听等子通道完全不起作用。你看到连接“恢复”了，其实是底层 SSH 连接没断，VSCode 只是重新挂载了 UI 层。
-
remote.SSH.keepAlive默认为60，但改大或改小都无济于事——它不发任何网络包 - 真正维持 TCP 连接活跃的是
ServerAliveInterval，必须写在~/.ssh/config里 - 如果只配客户端却没配服务端，
ServerAliveInterval发出的包会被sshd直接丢弃
本地 SSH 客户端必须加的三行配置
编辑 ~/.ssh/config，在对应 Host 块中加入：
ServerAliveInterval 60 ServerAliveCountMax 3 TCPKeepAlive yes
这三项不是可选：前两者定义心跳节奏和容错阈值，最后一项是保活的基础开关。
-
ServerAliveInterval 60表示每 60 秒发一次空包；设成 30 会增加探测频率，但对多数 NAT 设备无必要 -
ServerAliveCountMax 3意味着连续三次收不到响应才断开，避免偶发丢包误判 -
TCPKeepAlive yes必须显式开启，否则 OpenSSH 可能跳过保活逻辑（尤其 Windows 自带 OpenSSH 7.7p1 及更早版本）
远程服务器 sshd 必须确认的三项配置
登录服务器，检查 /etc/ssh/sshd_config 中这几行是否未被注释且值合理：
-
ClientAliveInterval 60—— 服务端主动探测客户端是否存活，不能只依赖客户端单向心跳 -
ClientAliveCountMax 3—— 和客户端保持一致，否则服务端可能比客户端更早断连 -
TCPKeepAlive yes—— 注意：仅靠它不够，它只检测底层 TCP 是否通，穿不过 NAT 老化
改完必须执行 sudo systemctl restart sshd，否则配置不加载。某些容器化环境（如 Docker 启动的 sshd）可能忽略该文件，需在启动命令中加 -o ClientAliveInterval=60 参数。
Windows 上 OpenSSH 的兼容性陷阱
PowerShell 内置的 OpenSSH（如 OpenSSH_for_Windows_7.7p1）在非交互式连接（Remote-SSH 启动的后台连接）中会忽略 ServerAliveInterval。
- 运行
ssh -V查版本，若含_7.7p1或更低，基本可以确定保活失效 - 升级方案：从 GitHub
Win32-OpenSSH下载新版，替换C:\Windows\System32\OpenSSH\下的文件 - 临时绕过：在 VSCode 设置中关闭
remote.ssh.useLocalServer，强制走独立 SSH 进程，有时能触发保活
最常被忽略的一点：VSCode Remote-SSH 断开后，远程 vscode-server 进程可能还活着并占着端口。下次重连失败，往往不是网络问题，而是旧进程卡死。务必先运行 Remote-SSH: Kill VS Code Server on Host 再重试。
