常见故障排查与使用异常快速指南

此类现象通常与系统运行环境或依赖组件有关。首先确认操作系统是否为 Windows 10 及以上，并已安装最新的 WebView2 运行时——这是 Tauri 框架正常渲染界面的前提。其次，部分安全软件会将 Mihomo 内核误判为可疑进程并阻断，请将其加入信任区。

快速排查：打开事件查看器或软件的日志目录，寻找包含 panic 或 runtime error 的记录。若错误指向端口绑定，可尝试先关闭其他同类代理工具，再以管理员身份重新启动本应用。

当所有节点均显示超时，首先应排除本地网络是否断连。若网页浏览正常，则问题大概率出在客户端配置或端口冲突上。检查 混合端口 是否被其他程序占用（如迅雷、音乐客户端或本地开发服务器），此类冲突会导致内核无法正常监听入站请求。

修复思路：进入设置面板将默认端口修改为冷门端口（如 27890），保存并重启核心。同时确认当前使用的策略组是否意外选中了“直连”或“拒绝”模式，导致所有请求被直接丢弃而非转发至节点。

YAML 格式对缩进和标点极其敏感。一个多余的空格或错误的冒号对齐，就可能导致整段规则被内核跳过。当发现某个域名未按预期分流时，立即打开 日志 面板并筛选该域名，红色 [Error] 行会明确指出具体行号和错误类型。

修复工具：你可以使用社区提供的在线 YAML 校验器粘贴配置片段进行排错，或直接利用软件内置的语法高亮编辑器逐行审查。修正后点击“重载配置”即可即时生效，无需重启整个应用。

订阅更新依赖本地网络能否触达托管服务器。若直连环境下反复失败，建议先临时开启 系统代理 并在配置中选择一个可用节点作为更新通道。部分订阅链接包含特殊字符（如汉字或符号）未被正确转义，也会导致 Rust HTTP 客户端解析异常。

操作建议：在设置中切换 用户代理 (User-Agent) 字段为常见浏览器标识，或尝试将订阅链接在浏览器中打开后另存为本地文件，再通过“从文件导入”功能加载。

这种现象通常说明系统代理设置已写入，但内核未能正常转发流量。先检查托盘图标是否显示“系统代理”已开启，再进入设置确认 混合端口 与系统代理中的端口号一致（默认 7890）。部分浏览器如 Firefox 若设置了独立代理，需手动指向 127.0.0.1:7890。

若端口无误，尝试在软件内切换一次全局模式，再切回规则模式，强制刷新内核的路由表。最后可重启浏览器以确保它重新读取系统代理环境变量。

TUN 模式需要在系统中注册一个虚拟网络适配器。Windows 用户务必右键以 管理员身份运行 并点击“是”允许 UAC 弹窗；macOS 用户需在系统偏好设置 > 隐私与安全性中允许网络扩展。若安装仍失败，通常是因为系统中已有其它虚拟网卡驱动（如 VPN 客户端、手游模拟器、虚拟机）占用了相同的适配器索引。

终极方案：在设备管理器中暂时禁用不常用的虚拟网卡，重新启动 Clash Verge Rev 后再次点击开启 TUN。若问题依旧，可尝试卸载并重新安装最新版，安装向导会自动修复驱动注册表。

配置目录通常位于用户文档或应用数据文件夹下，包含 profiles（订阅缓存）和 config.yaml（主配置）。定期将此文件夹整体打包为 ZIP 即可完成备份。重装系统或迁移设备时，将备份解压至相同路径，启动软件后所有节点、规则和自定义 Merge 脚本都将完整还原。

此外，软件内置了 导出配置包 功能，可在设置 > 备份与重置中生成便携版配置，便于在多台设备间同步你的精心调校成果。