Windows 安装教程

安装前准备

1. 备份订阅、本地 YAML 和自定义规则。
2. 退出旧版 Clash Verge，以及仍在运行的相关内核进程。
3. 确认安装包来自项目认可的 GitHub Releases。
4. 如果使用便携目录或自定义配置目录，记录当前路径。

图形安装步骤

1. 双击下载的安装程序。
2. 按安装向导完成安装，不确定时保留默认目录。
3. 启动 Clash Verge Rev，确认主界面、代理组和设置入口可以显示。
4. 导入订阅或本地配置，更新后选择一个可用节点。
5. 先开启系统代理测试浏览器连接，再按需配置 TUN。

使用 WinGet 安装

Windows 11 自带的包管理器可以按官方文档使用以下命令：

winget install ClashVergeRev.ClashVergeRev

使用包管理器前仍应核对包名称和来源。

界面空白或无法打开

先确认 WebView2 环境正常。只有在系统缺少 WebView2 且无法安装，或普通构建无法显示面板时，再尝试带有 fix_webview2 标记的官方安装包。也可以检查安全软件是否拦截主程序或内核进程。

验证安装结果

• 主界面能够正常打开。
• 订阅可以保存并更新。
• 代理页面可以显示策略组和节点。
• 关闭系统代理后，系统代理设置能够恢复。

便携版与安装版

安装版写入系统目录并注册开始菜单与右键菜单；便携版（Portable）把配置放在程序所在目录，适合在多台电脑间携带。使用便携目录时请记住路径，升级时直接覆盖程序即可，订阅与配置会随目录一起移动。

升级客户端

1. 在 GitHub Releases 下载新版本安装包或便携压缩包。
2. 覆盖安装，或解压便携版到原目录；用户目录下的配置通常保留。
3. 重新打开后执行一次订阅更新，确认节点与策略组正常。
4. 若界面异常，先完全退出旧进程再启动，必要时清理缓存。

常见问题排查

• TUN 模式开启失败：安装时需勾选服务模式，首次开启要允许管理员权限与防火墙放行。
• 缺少 WebView2：启动提示缺少运行时，按提示安装系统 WebView2 Runtime 后重试。
• 右键菜单无入口：确认使用的是安装版而非便携版，重装时勾选关联选项。

配置文件位置

订阅、覆写与日志默认存放在用户目录下的 Clash Verge 配置文件夹。修改前先导出备份，重装系统或换机时迁移该目录即可保留全部设置。