根本原因是ssh协议默认不发心跳包，导致网络设备主动断连；通过在~/.ssh/config中配置serveraliveinterval和serveralivecountmax启用客户端保活，并同步配置服务端sshd_config中的clientaliveinterval与clientalivecountmax，再配合vscode的autoreconnect等设置及严格权限控制，四层协同方可实现稳定连接。
VSCode 的 Remote-SSH 连接不是“断了再连”，而是根本没维持住——问题出在 SSH 协议层的空闲超时，默认值为 0，即不发心跳，等网络设备自己杀连接。
为什么改 ~/.ssh/config 就能起作用
VSCode Remote-SSH 底层调用的是你本地的 ssh 命令，它完全遵循 OpenSSH 的配置规则。只要你在 ~/.ssh/config 中为对应主机设置了保活参数，VSCode 启动连接时就会自动带上这些行为，无需插件额外设置。
-
ServerAliveInterval 60表示客户端每 60 秒主动向服务器发一次空包（不是数据，只是探测） -
ServerAliveCountMax 3表示连续 3 次没收到响应才断开，也就是最多容忍 3 分钟无响应 - 这两个参数必须成对出现，只设
ServerAliveInterval而不设ServerAliveCountMax时，OpenSSH 会使用默认值 0（立即断），反而更糟 - 别信“加个
TCPKeepAlive yes就行”——它只在 TCP 层起作用，对 NAT、防火墙无效；真正管用的是应用层心跳ServerAlive*系列
服务端 /etc/ssh/sshd_config 必须同步配
光客户端发心跳不够。如果服务端 sshd 自己先判定客户端失联，照样会单方面关闭连接。所以远程服务器上必须确认以下三项已启用：
Pandas 配置文件报告生成器
下载
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
-
ClientAliveInterval 60：服务端每 60 秒主动 ping 客户端一次 -
ClientAliveCountMax 3：允许客户端连续 3 次不回，才终止会话 -
TCPKeepAlive yes：作为兜底，防止底层 TCP 连接被中间设备静默回收 - 改完记得执行
sudo systemctl restart sshd，否则配置不生效
VSCode 自身设置里这几个键值很关键
Remote-SSH 插件本身有重连策略，但默认不开启或过于激进。打开 VSCode 的 settings.json（命令面板 → Preferences: Open Settings (JSON)），补上这几项：
-
"remote.autoReconnect": true：断开后自动尝试重连（不是“保持连接”，是“断了就重试”） -
"remote.SSH.showLoginTerminal": true：连接失败时弹出终端日志，方便定位卡在哪一步 -
"remote.SSH.useLocalServer": false：强制走系统ssh客户端，避免 Remote-SSH 自带精简版不认某些配置 - 别配
remote.SSH.timeout—— 这个是“建立连接”的超时（比如连不上服务器时等几秒放弃），和“连接后保活”完全无关
最容易被忽略的权限与路径陷阱
哪怕所有参数都写对了，~/.ssh/config 文件本身权限不对，OpenSSH 就会直接忽略它——这是 OpenSSH 的硬性安全限制。
- 检查权限：
ls -l ~/.ssh/config，输出中应为-rw-r--r--或更严格（如-rw-------），绝不能是-rw-rw-rw- - 如果权限过宽，执行：
chmod 644 ~/.ssh/config - 确保配置块中的
IdentityFile路径真实存在且可读，比如IdentityFile ~/.ssh/id_rsa对应的文件得真有，且权限是600 - Windows 用户注意路径分隔符：VSCode 里写
IdentityFile C:\Users\you\.ssh\id_rsa或正斜杠C:/Users/you/.ssh/id_rsa都可以，但双反斜杠或单反斜杠混用会失效
真正稳定的连接，靠的不是某一个参数，而是客户端心跳 + 服务端心跳 + VSCode 重连策略 + 文件权限合规这四层同时生效。少一层，24 小时内大概率还会断一次。
