在 GitHub 发布页下载 Clash 电脑端时,很多人会点到 Source code(zip 或 tar.gz)。解压后看不到安装程序,双击文件夹也无法完成安装。这通常不是文件损坏,而是下到了源代码而不是安装包。下面只说明这一情况的适用条件、判断依据、正确处理方式,以及仍失败时该怎么做。
为什么 Source code 不能直接安装
Clash Verge Rev 官方仓库写明:请到发布页面下载对应的安装包。电脑端支持 Windows(含 x64 等)、Linux 以及 macOS 11 及以上。发布页提供的是已经编译好的安装文件,例如 Windows 的 setup.exe、macOS 的 dmg、Linux 的 deb 或 rpm。
GitHub 在每个版本发布时,都会自动附带一份仓库源代码压缩包,名称通常就是 Source code。它对应项目源码,用来查看代码或自行构建,不是给普通用户直接安装的程序。源码解压后常见的是工程目录、前端与 Tauri 相关文件和说明文档,里面没有对应系统的安装器,因此不能当作安装包使用。
官方开发说明也把源码的用途写清楚了:要在开发环境运行,需要先具备 Tauri 的前置条件,再安装依赖并执行构建或开发命令。这是开发构建流程,不是日常安装路径。所以只下载 Source code 后,不能按普通软件那样直接安装成可用的桌面客户端。
如何判断下到的是源码而不是安装包
先看文件名和后缀。安装包会带有明确的平台标识,例如 Windows 的 Clash.Verge_版本号_x64-setup.exe 或 arm64-setup.exe,macOS 的 aarch64.dmg 或 x64.dmg,Linux 的 amd64.deb、x86_64.rpm 等。Source code 一般是 zip 或 tar.gz,且没有 setup、dmg、deb、rpm 这类安装后缀。
再看解压内容。若解压后主要是源代码和工程文件,找不到上述安装包,即可判定当前文件不能用于直接安装。官方发布说明还会区分 Windows 的正常版本与内置 Webview2 版本、macOS 的芯片架构、Linux 的 DEB 与 RPM;这些说明只对应安装包条目,不会出现在 Source code 条目里。
适用条件可以概括为:你在 clash-verge-rev 的 Releases 页面下载,目标是安装电脑端图形界面,但实际拿到的是源码压缩包。若你本来就要编译源码,则不属于“不能安装”的故障,而应走开发构建流程,与普通安装不是同一条路。
正确下载方式与失败时的下一步
回到发布页,在该版本的资源列表中按操作系统选择安装包,不要选择 Source code。Windows 不再支持 Win7;常用 64 位选择 x64-setup.exe,ARM 设备选择 arm64。仅在企业版系统或无法安装 Webview2 时,才考虑体积更大的 fixed_webview2 安装包。macOS 按芯片选择 Apple 芯片的 aarch64.dmg 或 Intel 的 x64.dmg。Linux 的 Debian 系使用 deb,并用 apt 加本地路径安装;Redhat 系使用 rpm,并用 dnf 加本地路径安装。仓库对发行版的划分是:Stable 正式版适合日常使用;AutoBuild 为滚动更新,可能存在缺陷。普通安装应选正式版安装包。
若已经下载并解压了 Source code,将该压缩包或文件夹归档或删除即可,不必尝试“安装”该目录。重新下载对应安装包后再安装。
若按安装包安装仍失败,先核对系统架构是否与文件名一致,例如把 ARM 包用在 x64 上会无法按预期完成安装。Windows 还需确认当前环境是否需要内置 Webview2 的包。官方仓库同时指向文档页和常见问题,用于查阅安装说明。若目的确实是从源码运行,应先完成 Tauri 开发前置条件,再按仓库给出的依赖安装、prebuild 与开发运行流程操作;该路径不能替代安装包,也不能把源码目录当作绿色版或便携版使用。发布页里的安装包资源才是普通用户的安装入口。
https://github.com/clash-verge-rev/clash-verge-rev/releases https://github.com/clash-verge-rev/clash-verge-rev