Clash Verge Rev 提示「检查更新失败」「下载更新失败」或点了更新一直转圈,不等于客户端已经坏掉。更常见的是:更新通道被拦、旧安装半残、权限不够写安装目录,或你其实已是最新稳定版但检查接口超时。先分清检查失败、下载失败、安装替换失败,再按最小步骤处理,避免一上来就删配置。
订阅更新失败是另一条链路,见订阅更新失败。本文只谈应用本身的版本更新。安装包始终优先从下载中心获取可核验文件;新手路径见上手教程。
先分清三种失败,别和订阅搅在一起
检查更新失败:客户端连不上更新元数据或 GitHub Releases 一类源。网络、DNS、代理自身、公司防火墙都可能导致。版本号其实已最新时,仍可能因超时弹出失败——对照下载中心版本号即可,不必为此重置。
下载更新失败:已经查到新版本,但安装包下不完整或校验失败。磁盘满、杀软隔离、代理中途断开较常见。
安装 / 替换失败:文件下到了,但写不进安装目录、旧进程未退出,或 SmartScreen / 杀软拦截新文件。Windows 安装提示见SmartScreen 与管理员。订阅能更新、应用不能更新,说明两条通道独立——别把机场问题当成客户端损坏,也别把应用更新失败当成「该清订阅」。
推荐排查顺序:检查 → 通道 → 手动包
- 看「关于 / 设置」里的当前版本号,对照下载中心或 Releases 是否已是最新稳定版。已是最新却仍报错,多半是检查通道超时,可忽略或稍后重试。
- 确认本机代理大体可用:浏览器能开网页。若代理本身半残,更新检查更容易失败——先修系统代理或换节点。
- 临时用 Rule + 可用节点,再点检查更新;仍失败则不要死磕应用内更新,改为手动下载安装包覆盖安装。
- 手动安装前退出客户端,结束残留进程,避免文件占用。装完打开,确认版本号变化。
- 若覆盖安装后仍异常,再考虑服务重装(Tun 用户,见服务模式)或安全重置,而不是先格式化。
为什么手动安装包往往更稳
应用内更新依赖「检查 → 下载 → 替换」长链路,任何一环被拦都会失败。手动从下载中心取安装包,等于你自己完成下载与校验,只保留替换步骤。对网络不稳、公司代理、GitHub 间歇不可达的环境,这是默认止损——把「检查更新」当锦上添花,把下载中心当主渠道。
手动更新一般不应清掉用户配置,但也不会自动帮你备份订阅。若你曾改过 Merge / 端口,更新后核对一次混合端口与模式(见混合端口、三种模式)。macOS「已损坏」类提示见macOS 无法打开。公司网无法检查更新很常见:用手机热点对比,或直接手动下载,不要把防火墙误判成客户端损坏。
手动包从下载中心取回后,可对照发布页给出的校验值核对一次,确认文件在传输途中没被动过再安装。
权限、杀软与残留进程
安装目录在 Program Files 时,没有管理员权限可能表现为「下载成功但安装失败」。先退出 Clash,再以管理员运行安装包。杀软若隔离了更新临时文件或新版本主程序,到隔离区恢复并加放行,再重试。
残留进程占着旧文件:任务管理器结束相关进程后再装。反复失败且伴随核心通信错误时,对照内核通信与日志排查,确认不是更新半残导致核心文件损坏。休眠唤醒后「假更新失败」也可能是网络栈未就绪,先按唤醒断网恢复,再点检查更新。
止损与验收:何时别再点检查更新
止损标准:你能说出当前版本号;手动安装包可打开;订阅仍在且系统代理或 Tun 按原习惯可用。应用内更新长期不可用但手动更新正常,可以接受——不必为此清空配置。
更新前后建议记一笔:旧版本号、新版本号、混合端口、是否开 Tun。出问题时你能立刻回答「是更新引入的,还是唤醒 / 订阅本来就有的」。很多人把三件事搅在一起,最后误删配置。
若手动安装后配置全丢:说明装到了另一用户目录或你误做了重置,用备份订阅导回(备份迁移、配置位置)。同一周内连续三次应用内更新失败、手动包却正常,停手改用手动渠道即可。更多入口见常见错误索引;干净包回下载中心。