这篇指南适用于 Windows 10/11 上的 Clash Verge Rev 安装和首次启动。已经安装但出现空白窗口,或只能看到托盘图标,可以直接进入启动排障。主界面能正常显示后,订阅导入和连接设置请继续阅读新手教程。
先根据现象选择入口,每完成一步都重新启动并检查界面;恢复正常后就停止这一层排查。
| 你看到的现象 | 从哪里开始 |
|---|---|
| 安装或运行时提示“此应用无法在你的电脑上运行” | 核对系统类型与安装包架构 |
| 窗口空白、白屏,或只有托盘图标且打不开主界面 | 检查窗口和 WebView2 |
| WebView2 安装报错或始终装不上 | 处理运行时安装失败 |
| 主界面正常,但节点超时或无法联网 | 节点与订阅超时排查 |
安装前:确认系统与安装包架构
打开 Windows“设置 → 系统 → 关于”(部分版本显示为“系统信息”),查看设备规格中的“系统类型”。以这里显示的架构为准,不按电脑品牌、价格或是否为新机判断。
| 系统类型 | 应选择的普通安装包后缀 |
|---|---|
| 基于 x64 的处理器,64 位 Windows;常见于 Intel、AMD 电脑 | x64-setup.exe |
| 基于 ARM 的处理器,ARM64 Windows;例如部分高通设备 | arm64-setup.exe |
x64 与 ARM64 是不同架构,不能把 ARM64 当作更高级的通用版本。 遇到“此应用无法在你的电脑上运行”,先重新核对系统类型、完整文件名和下载来源。架构匹配后仍报错,再记录错误信息继续求助,不反复交替试装。
Clash Verge Rev 当前不再支持 Windows 7。x64 或 ARM64 的选择不能解决系统版本不受支持的问题;官方建议改用 Windows 10/11 或受支持的 Linux 桌面系统。上面两种安装包也不适用于 32 位 Windows。
优先选择普通安装包。文件名带 fixed_webview2 的是内置 WebView2 运行时的版本,体积更大;适用于运行时无法正常补装,或已经安装运行时仍打不开面板等情况,见内置版本的使用步骤。不确定系统是否支持时,可查看官方安装说明。
方法一:使用安装包
- 打开本站的 Clash Verge Rev 下载中心,找到 Windows 区域。
- 根据系统架构下载 x64 或 ARM64 安装版。下载中心同时提供 GitHub 官方链接和 gh-proxy.com 第三方镜像;拿不准时优先使用官方链接。
- 双击下载的
.exe文件,按安装向导完成安装。第一次安装时保留默认安装位置即可。 - 从开始菜单打开 Clash Verge Rev,检查侧边栏和设置页能否显示并响应点击。仅看到托盘图标,还不能确认主界面正常。
如果 Windows 对下载文件显示来源提醒,请先确认文件来自项目 GitHub Release 或本站下载中心列出的同一官方地址,再继续运行;来源不明的同名安装包不要使用。
方法二:使用 WinGet
Windows 11 用户也可以在 PowerShell 或 Windows 终端中执行:
winget install ClashVergeRev.ClashVergeRev这是官方安装文档列出的安装方式。需要精确选择安装文件,或者 WinGet 无法正常获取软件时,改用上面的安装包方式更直观。
启动后空白窗口或只有托盘图标
先把“窗口没有显示出来”和“窗口无法渲染”分开。以下步骤根据官方 Windows FAQ整理,WebView2 是重点检查项,但空白窗口本身不能证明运行时一定缺失。
第一层:确认能否唤出主界面
- 展开 Windows 任务栏通知区域,找到 Clash Verge Rev 托盘图标,尝试通过托盘菜单打开主界面。
- 若窗口能够打开、侧边栏和设置页均可操作,说明这次只是未显示主窗口,无需因此重装 WebView2。继续做文末的首次启动验收。
- 若点击后没有反应,或窗口打开后一直空白,进入下一层。有托盘图标只说明程序至少启动了部分组件,不代表界面已经可用。
第二层:检查 WebView2 是否被禁用
Clash Verge Rev 需要 WebView2 来显示 Windows 主界面。若曾用精简、优化或隐私工具禁用 Edge,回到该工具检查是否连带禁用了 WebView2;如有,恢复 WebView2 的启用状态,然后完全退出并重新启动 Clash Verge Rev。
重新打开后,检查主界面是否完整、页面能否切换。若仍空白或从未禁用过,继续检查运行时安装。Edge 浏览器和 WebView2 Runtime 是不同组件,不能仅用“Edge 能打开”判断运行时正常。
第三层:补装 WebView2 Runtime
在 Windows 的“已安装的应用”或“应用和功能”中查找 Microsoft Edge WebView2 Runtime 作为初步检查。若曾卸载它、列表中找不到,或安装状态不明确,使用微软官方安装器检查并补装,不下载来历不明的修复工具。
打开微软 WebView2 下载页,找到运行时下载区域,按当前联网条件选择:
| 下载项 | 适用情况 |
|---|---|
| Evergreen Bootstrapper(在线引导安装器) | 当前电脑可以访问微软下载服务;安装器会自动选择设备架构 |
| Evergreen Standalone Installer(离线完整安装器) | 在线安装器无法完成下载;先取得完整文件,再在目标电脑安装,选择对应的 x64 或 ARM64 |
安装完成后,完全退出 Clash Verge Rev,再从开始菜单打开,重新检查侧边栏与设置页。关闭窗口后若程序仍留在托盘,可通过托盘菜单退出;仅关闭再唤出同一个窗口不等于重新启动。
如果安装器提示已安装,但面板仍打不开,保留提示并跳到内置版本;如果安装失败,则先处理下一层。无需先卸载 Edge,也不必先删除订阅和配置。
第四层:WebView2 无法正常安装
- 记下微软安装器的完整报错或错误码,区分下载失败与安装失败。在线安装器下载失败时,先尝试上面的离线完整安装器。
- 检查 Windows Update 是否被关闭或被优化工具禁用。官方 FAQ 将关闭自动更新列为可能原因;个人设备可恢复自动更新后重试。若设置由组织管理,应交由管理员处理。
- 重试成功后重新启动 Clash Verge Rev 验收;仍无法安装时,进入内置版本分支。恢复更新只是一个检查方向,不代表所有安装错误都会因此消失。
第五层:尝试内置 WebView2 版本
这一步适用于两种情况:WebView2 无法补装;或运行时已经安装且启用,重新启动后主面板仍无法显示。
- 返回下载中心,在 Windows 区域展开“无法安装 WebView2?查看特殊版本”,选择内置 WebView2 版本。
- 再次核对架构:x64 电脑的文件名应含
x64_fixed_webview2-setup.exe,ARM64 电脑应含arm64_fixed_webview2-setup.exe。 - 退出正在运行的 Clash Verge Rev,运行对应安装包,按向导完成安装后重新打开。
- 若窗口内容和设置页恢复,结束启动排障;若仍空白,记录使用的完整文件名和结果,转到下面的求助步骤。
这里需要的是 Clash Verge Rev 自带运行时的安装包,不是微软下载页供开发者打包应用的 Fixed Version 文件。内置版不保证解决所有闪退、架构不匹配或网络连接问题。
完成上述检查仍打不开
出现具体错误时,按错误转查:VCRUNTIME…dll 缺失属于 VC 运行库分支;启动后进程立即退出则需要进一步排查闪退。官方 FAQ 也提到安全软件拦截服务安装的情况,可先查看拦截记录,不要把关闭安全软件或防火墙当作白屏通用修复。
向官方 GitHub Issues搜索相同错误或反馈时,至少整理:
- Windows 版本与系统类型、Clash Verge Rev 版本和完整安装包文件名。
- 是空白窗口、只有托盘且点击无反应,还是启动后立即退出;附准确报错或截图。
- WebView2 是否曾被禁用、补装结果、内置版本是否尝试过,以及每一步之后现象有无变化。
若界面偶尔可以打开,再按官方日志导出说明调整日志级别、退出重启并复现,保留当日序号最新的日志。官方区分 GUI 日志和 service 子目录中的内核日志;界面故障先关注 GUI 记录。完全无法进入设置时,先提交已经取得的环境与错误信息,不必为了导出日志反复重装。分享前检查并遮去订阅地址、令牌等敏感内容。
首次启动验收与下一步
确认主窗口显示完整、侧边栏可切换、设置页可操作,并在完全退出后能再次正常打开,才算通过这里的界面验收。界面正常不等于已经可以代理上网:
- 首次配置继续阅读导入订阅、选择节点并开启系统代理。
- 所有节点显示超时或实际访问失败,转到节点与订阅超时排查。
- 只有部分程序不走系统代理,或启用 TUN 后异常,再看TUN 模式教程与排障。
其他启动问题可查看 Clash Verge Rev 官方 Windows 常见问题。
