疑难解答进阶
客户端更新后无法使用怎么办？版本兼容排查
升级出问题，八成是旧配置跟不上新内核，或者系统服务在升级时失效。重导订阅和重开 TUN 能解决大部分情况，回退版本留作保底。
简要回答
先打开客户端日志看报错关键字。配置解析类报错，删掉旧订阅后从机场后台重新导入；内核退出或 TUN 自动关闭，以管理员身份重新开启 TUN 或服务模式，让客户端重装系统服务；前两步都无效，备份配置目录后从官方发布页下载上一个稳定版覆盖安装。
为什么一升级就出问题
图形客户端由两部分组成：你看到的界面，以及真正转发流量的内核。
内核Core
负责解析配置、建立代理连接的程序，例如 mihomo、Xray、sing-box。界面只是它的外壳。
升级后常见的冲突有三类：新内核不再认识旧配置里的某些字段；界面和内核版本对不上；TUN 依赖的系统服务、系统扩展在升级过程中被移除或失去授权。sing-box 对配置格式尤其敏感，大版本之间改字段是常事。
第一步：看日志关键字
Clash Verge Rev 的日志在左侧「日志」页，v2rayN 主界面下方就有日志窗口，sing-box 直接看启动时的输出。不同关键字对应不同的处理方向，下面逐个说明。
现象日志出现 unknown field、decode error 或 yaml: unmarshal
检查旧配置是否与新内核的格式不兼容
删掉原来的订阅条目，回到机场用户中心重新复制订阅链接并导入，让客户端拿到符合新格式的配置。如果机场的订阅本身就不兼容新版本，可以先联系客服，或暂时回退客户端。导入方法见订阅更新失败怎么办。
现象提示内核已退出、core exited，或内核根本没启动
检查内核与界面版本是否匹配、内核文件是否被杀毒软件删除
在客户端设置里确认内核版本，必要时重新安装完整的新版安装包，而不是只替换界面。检查杀毒软件隔离区，把客户端目录加入信任列表。
现象TUN 开关打开后自动弹回，或提示服务未安装
检查服务模式或系统扩展是否需要重新安装
Windows 上 Clash Verge Rev 的 TUN 依赖「服务模式」，macOS 依赖系统扩展。以管理员身份运行客户端，在设置里先关闭再打开 TUN 或服务模式，按提示授权，客户端会重新安装服务。TUN 的原理和系统代理的区别见开启代理后没有网络怎么办。
现象没有任何日志，界面白屏或打不开
检查系统运行库是否缺失
这通常不是配置问题。Windows 上检查 WebView2 运行库是否正常，macOS 上检查系统是否拦截了新版本的签名，重新从官方下载安装包。
第二步：保底方案，回退稳定版
备份配置目录
Clash Verge Rev 在 Windows 上的配置目录是
%APPDATA%\io.github.clash-verge-rev.clash-verge-rev\，macOS 上是~/Library/Application Support/io.github.clash-verge-rev.clash-verge-rev/。其他客户端在设置里通常能找到打开配置目录的入口。从官方发布页下载上一个稳定版
Clash Verge Rev、v2rayN、sing-box 都在各自的 GitHub Releases 发布版本。选标注为正式版的上一个版本，不要选预览版。
覆盖安装并重新导入订阅
覆盖安装后先更新一次订阅，再测试连接。
预防：让下次升级更顺利
- 自定义规则写在覆写或合并配置里，不直接改订阅文件。
- 升级前顺手备份配置目录。
- 关注客户端发布说明中「破坏性变更」一类的提示。
各客户端的常规设置可以参考 V2RayN 使用教程、Clash 教程和 sing-box 教程。
快速自查清单
| 检查项 | 正常表现 |
|---|---|
| 客户端日志 | 没有配置解析或内核退出的报错 |
| 订阅 | 已删除旧条目并重新导入 |
| 内核版本 | 与当前界面版本配套 |
| TUN 或服务模式 | 开启后不再自动弹回 |
| 杀毒软件 | 没有隔离客户端文件 |
| 安装来源 | 来自官方 GitHub Releases |
常见问题
回退旧版本会丢失订阅和设置吗？
一般不会。覆盖安装时用户数据保存在配置目录里，不随程序删除。保险起见，回退前先把配置目录整份复制一份。
为什么升级后我自己加的规则不见了？
直接改订阅生成的配置文件，在更新订阅或升级时很容易被覆盖。自定义规则应写在客户端的覆写或合并配置功能里，和订阅本身分开保存。
可以去第三方网站下载旧版本吗？
不要。代理客户端能接管全部网络流量，被篡改的安装包风险很高。只从项目官方的 GitHub Releases 下载。