安装或运行 Clash 相关程序时弹出不兼容,多数是发行包和当前环境对不上,而不是配置文件写错。先不要反复换同一类安装包,应依次核对三项信息:操作系统及版本、处理器与系统架构、二进制编译标签(含 AMD64 微架构等级)。这三项分别对应文件名里的系统字段、架构字段,以及 v1/v2/v3、compatible、go 版本一类标记。三项都对上再换包,才能判断是选错文件,还是当前硬件和系统本身不在支持范围内。
第一项:操作系统及版本
适用条件:安装包无法启动、提示系统不受支持,或发行说明已写明停止支持某一代系统。先确认本机是 Windows、Linux 还是 macOS,再把大版本号、内核版本和该构建的支持范围对照。
Clash Verge Rev 的安装说明写明现版本已经不再支持 Windows 7;Windows 7 需要先升级到 Windows 10/11,或改用 Linux 桌面发行版。macOS 侧,该客户端文档写明支持 macOS 12 及以上。macOS 11 若仍要继续用,文档给出的做法是自行下载带 go124 标签的 mihomo 内核,替换应用包内的核心文件,并建议更新系统以获得更好支持。内核 FAQ 进一步按 Go 版本划线:Go 1.25 起不再支持 macOS 11,macOS 11 应选 go124,macOS 10.15 应选 go122,macOS 10.13 应选 go120。Linux 上,Go 1.24 起仅支持 3.2 及以上内核;内核落在 2.6.32 到 3.1 时,应下载带 go123 标签的二进制。
判断依据:系统名称、版本号、Linux 内核版本必须与发行说明和 FAQ 中的标签规则一致。失败时下一步:版本低于当前 GUI 支持范围时优先升级系统;暂时不能升级时,改选 FAQ 标明的对应 go 标签内核,而不是继续安装默认包。
第二项:处理器与系统架构
适用条件:提示架构不符、程序无法执行,或不确定该选 x64 还是 ARM64。架构要同时看 CPU 和操作系统位数,文件名里的 amd64、x64、arm64、386、armv7 必须与本机一致。
Windows 可用系统信息确认:开始菜单打开运行框,输入 msinfo32.exe,查看 System Type。32 位显示为 x86-based PC,64 位显示为 x64-based PC。也可在命令提示符执行 wmic os get OSArchitecture,或使用 systeminfo。常见对应关系是:x64/amd64 对应 64 位 x86_64,arm64 对应 ARM 64 位,386 对应 32 位 x86;Linux 另有 armv7。Clash Verge Rev 文档说明,若不清楚电脑系统架构,请下载 x64 架构文件,因为目前多数 Windows 电脑使用该架构,同时提供 arm64。macOS 需区分 Intel 芯片与 Apple M 芯片。Linux 按发行版选择 deb 或 rpm,并匹配 x64、arm64 或 armv7。
判断依据:安装包架构字段与 System Type 或 OSArchitecture 一致。虚拟机、PVE 嵌套、ARM Windows 更容易下错包。失败时下一步:32 位系统不要用 amd64 包,ARM 设备不要用 x64 包;仍不确定时,Windows x86 机器可按文档优先选 x64,但 ARM 机器必须改选 arm64。
第三项:编译标签与 CPU 微架构等级
适用条件:系统和架构已经选对,运行时仍出现微架构不支持一类英文提示。mihomo 在 AMD64 上用 v1/v2/v3 标记 CPU 指令集等级:默认无额外标识的包按 GOAMD64=v3 编译;文件名含 compatible 的包按 GOAMD64=v1 编译,用于兼容特定系统或架构。公开工单中,linux-amd64 在部分 CPU 上会提示只能在具备 v3 微架构支持的 AMD64 处理器上运行;改成 compatible 后,又可能提示需要 v2 微架构支持。这说明“架构是 amd64”并不等于“满足默认 v3 指令集”。虚拟机若暴露了过低的 CPU 型号,也容易触发同一类提示。
判断依据:报错文本中的 v2、v3 与文件名标签对照。默认包对应更高指令集,compatible 对应 v1。失败时下一步:默认 amd64 报 v3 不支持时,改下 compatible;若 compatible 仍报需要 v2,说明当前 CPU 连 v2 都未满足,该环境无法使用对应 Meta/mihomo 构建,需要更换物理机、调整虚拟机 CPU 型号,或改用明确支持更低指令集的构建,而不是反复安装同一默认包。
三项核对后的处理顺序
先对操作系统与版本,再对架构,最后对编译标签。GUI 安装包还要与内置内核一致:Clash Verge Rev 发布页同样按 64 位与 ARM64、Intel 与 Apple M、deb/rpm 分类,并标明 Windows 不再支持 Win7。核对以本机查询结果为准,不要只看下载页默认项。三项都匹配后仍无法启动,再查看是否缺少 WebView2、服务权限等安装问题;那些已超出“选错兼容包”的范围,应按对应客户端的安装问题说明继续排查。
https://wiki.metacubex.one/startup/faq/ https://github.com/MetaCubeX/mihomo/issues/393 https://learn.microsoft.com/en-us/archive/technet-wiki/11419.windows-how-to-determine-whether-you-are-running-a-32-bit-or-a-64-bit-edition https://www.clashverge.dev/install.html https://github.com/clash-verge-rev/clash-verge-rev/releases