客户端升级后连不上、配置报错、界面异常，多半是新版本改了配置格式或内核要求。按三步走：先重新导入机场当前订阅（旧本地配置格式可能已过时），再重新开一次 TUN / 服务模式（系统服务常在升级时失效），还不行就回退到上一个稳定版。前两步能解决大部分，回退是保底不是首选。
看日志确定是哪一类
升级后的故障几乎都能从日志第一行分出类型。Clash Verge Rev 在「日志」页查看，sing-box 看启动输出：
| 日志关键字 | 说明 | 去哪一步 |
|---|---|---|
unknown field / decode error / yaml: unmarshal | 配置字段变了，旧配置解析不了 | 重导订阅 |
core exited / 内核已退出 | 内核与界面版本不匹配，或内核文件被杀毒拦 | 内核无法启动 |
service not installed / 服务未安装 / TUN 弹回 | 系统服务需要重装 | 重开 TUN |
| 完全没日志、界面白屏 | 运行库问题 | Windows 客户端打不开 |
第一步：重导订阅，别沿用旧配置
新版本改字段格式时，机场那边通常已更新订阅模板，你本地缓存的还是旧格式。做法：删掉旧订阅条目，从机场用户中心重新复制链接导入，让客户端拉一份全新的。自定义过的规则用「订阅覆写」保存，别直接改订阅文件——这也是更新后自定义丢失的常见原因。
第二步：重装系统服务
Windows 上 Clash Verge Rev 的 TUN 依赖「服务模式」，macOS 依赖系统扩展，升级后二者都可能失效。到设置里关掉再打开 TUN，客户端会重新触发安装并弹出授权；Windows 以管理员身份运行客户端再操作。
第三步：回退到上一个稳定版
只从官方发布页拿旧版本（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/
回退前把这个目录备份一份，万一新旧版本配置互不兼容还能还原。系统大版本刚发布的头几周，客户端适配往往还没跟上，这段时间不着急升级是最省事的做法。各客户端的官方获取方式见客户端教程。
常见问题
更新后配置报错怎么办？
新版可能改了配置字段格式。重新导入机场当前的订阅（机场模板通常已适配新版），而不是沿用旧的本地配置。
可以回退旧版本吗？
可以。到官方发布页下载上一个稳定版覆盖安装，先恢复可用，再等新版修复。切勿从非官方渠道下载旧版。
TUN 模式更新后失效？
新版可能需要重新安装系统服务。在设置里重新开启 TUN 触发服务安装，按提示授权。