客户端更新后无法使用怎么办？版本兼容排查

先说结论：更新后用不了，按三步走——① 重新导入机场当前订阅（旧的本地配置格式可能已过时）；② 重新开一次 TUN / 服务模式（系统服务常在升级时失效）；③ 还不行就回退到上一个稳定版。三步里前两步能解决大部分，回退是保底，不是首选。

看日志确定是哪一类

升级后的故障几乎都能从日志第一行分出类型，Clash Verge Rev 在「日志」页，sing-box 在启动输出里：

日志关键字	说明	去哪一步
unknown field / decode error / yaml: unmarshal	配置字段变了，旧配置解析不了	重导订阅
core exited / 内核已退出	内核与界面版本不匹配，或内核文件被杀毒拦	内核无法启动
service not installed / 服务未安装 / TUN 弹回	系统服务需要重装	重开 TUN
完全没日志、界面白屏	运行库问题	Windows 客户端打不开

第一步：重导订阅，别沿用旧配置

新版本改字段格式时，机场那边通常已经更新了订阅模板，你本地缓存的还是旧格式。做法：删掉旧订阅条目，从机场用户中心重新复制链接导入，让客户端拉一份全新的。自定义过的规则用「订阅覆写」保存，别直接改订阅文件——这也是更新后自定义丢失的常见原因。

sing-box 对配置格式最敏感，几乎每个大版本都有字段变更，报错细节见 sing-box 配置无法启动。

第二步：重装系统服务

Windows 上 Clash Verge Rev 的 TUN 依赖「服务模式」，macOS 依赖系统扩展，升级后二者都可能失效。到设置里关掉再打开 TUN，客户端会重新触发安装并弹出授权；Windows 以管理员身份运行客户端再操作。授权流程见TUN 模式开启失败。

第三步：回退到上一个稳定版

只从官方发布页拿旧版本（Clash Verge Rev 与 sing-box 都在各自的 GitHub Releases，下载中心的直链每双月从官方渠道刷新）。覆盖安装即可，用户数据保留在配置目录里不会丢：

• Windows：%APPDATA%\io.github.clash-verge-rev.clash-verge-rev\
• macOS：~/Library/Application Support/io.github.clash-verge-rev.clash-verge-rev/

回退前把这个目录备份一份，万一新旧版本的配置互不兼容还能还原。系统大版本刚发布的头几周，客户端适配往往还没跟上，这段时间不着急升级是最省事的做法。

同类客户端问题见网络问题排查 · 客户端与系统，各客户端的官方获取方式见客户端教程。