故障排查 中心
针对 Mihomo 内核联网失败、节点连不上、无法访问等问题，从网络权限、系统防火墙、内核运行状态多维度提供修复方案。
🔍 三分钟快速自检
检查系统托盘
确认 Verge 图标在系统托盘可见。若没有，可能在后台静默运行，尝试右键托盘区查看隐藏图标。
确认内核状态
打开面板查看日志页，确认 Mihomo 内核是否正常加载。红色报错行通常指向配置问题或端口冲突。
切换代理模式
在全局、规则、直连三种模式间切换一次，有时模式状态异常会导致看似“无法连接”的假象。
启动与运行异常
Clash Verge 无法启动怎么办？
首先检查系统托盘区域是否已有 Verge 图标在运行（有时窗口未弹出但后台已启动）。若确认未运行，尝试以下步骤：
1. Windows 用户：右键以管理员权限运行 Verge，检查 Windows Defender 防火墙是否拦截了程序联网。可以在「控制面板」→「Windows Defender 防火墙」→「允许应用通过防火墙」中将 Verge 加入白名单。
2. macOS 用户：前往「系统设置」→「隐私与安全性」，在安全性区域查看是否有关于 Clash Verge 的提示，点击「仍要打开」。
3. 如果以上步骤无效，建议从官方下载中心重新获取最新版本进行覆盖安装，旧版本可能存在兼容性问题。
Mihomo 内核更新失败怎么办？
内核更新失败通常由网络问题或权限不足导致。打开 Clash Verge，进入「设置」→「内核」页面：
1. 点击「检查更新」按钮，观察是否有新版本可用以及下载进度。
2. 如果自动更新持续失败，可访问 Mihomo GitHub Releases 页面手动下载对应系统的内核文件，然后替换到 Verge 的内核目录（通常在 Verge 安装目录下的 resources 或 core 文件夹）。
3. 替换完成后，务必重启 Clash Verge 客户端使新内核生效。
macOS 提示“已损坏无法打开”怎么办？
这是 macOS Gatekeeper 安全机制导致的提示，并非文件真的损坏。解决方法如下：
1. 打开「终端」应用（在启动台→其他 或 Spotlight 搜索“终端”）。
2. 输入以下命令并回车：sudo xattr -rd com.apple.quarantine /Applications/Clash\ Verge.app
3. 输入管理员密码（密码输入时不显示字符），回车后即可正常打开 Verge。此操作仅移除 macOS 对该应用的隔离标记，不会影响软件本身的安全性。
连接与代理问题
TUN 模式开启失败怎么解决？
TUN 模式需要系统级虚拟网卡驱动的支持，开启失败通常与驱动安装或系统权限有关。
1. 在 Clash Verge 的「设置」→「通用」中，找到 TUN 相关选项，点击「安装/更新 TUN 驱动」。Windows 系统会安装 Wintun 驱动，macOS 会安装系统扩展。
2. macOS 用户：安装驱动后需前往「系统设置」→「隐私与安全性」，在底部允许来自 Clash Verge 的系统扩展，然后重启 Mac。
3. Windows 用户：如果驱动安装后仍报错，检查是否有其他 VPN 软件占用了虚拟网卡，关闭或卸载冲突软件后再试。
4. 部分安全软件（如360、腾讯管家）可能拦截 TUN 驱动加载，将 Verge 加入信任列表即可。
订阅导入失败是什么原因？
订阅导入失败是最常见的咨询问题之一，通常由以下几个原因造成：
1. 订阅链接已过期：联系你的服务提供商确认订阅是否仍在有效期内。
2. 网络无法访问订阅地址：部分订阅链接被墙或需要特定网络才能访问。可以尝试先开启一个可用的代理，再导入新订阅。
3. 链接格式不正确：确保粘贴的是完整的 URL（以 http:// 或 https:// 开头）。如果手头有 YAML 格式的配置文本，也可以选择「手动粘贴配置」方式导入。
4. 客户端版本过旧：极少数情况是老版本对订阅格式兼容不佳，更新到最新版即可解决。
为什么规则模式无法生效？
规则模式不生效的排查思路：
1. 确认在 Clash Verge 主界面顶部的模式切换器中已选中 「Rule」规则模式，而非 Global 或 Direct。
2. 检查「配置」页面中的 Rule Provider 是否成功加载——绿色状态表示规则集在线且已同步，红色则表示加载失败。
3. 在「日志」页面查看实时连接记录，观察具体请求匹配到了哪条规则。如果匹配结果与预期不符，说明规则编写有误或规则集未包含该域名。
4. 尝试在规则页面点击「更新全部规则」按钮，手动刷新规则缓存。
其他常见故障
节点全部超时（Timeout）怎么排查？
节点全部超时通常不是单个节点的问题，而应从网络环境和客户端设置入手：确认系统时间是否准确（时间偏差过大会导致加密握手失败）；检查防火墙是否拦截了 Verge 的出站连接；尝试关闭再重新开启系统代理或 TUN 模式；如果使用了代理链，检查上游代理是否正常。
Clash Verge 占用内存过高怎么办？
如果发现 Verge 内存占用异常，可尝试以下优化：减少 Rule Provider 的规则集数量，移除非必要的规则；在设置中增大日志清理频率；关闭不必要的自动测速任务；如果长期运行，重启客户端可释放累积的内存碎片。正常情况下，Mihomo 内核的内存占用应稳定在 100-300MB 之间。
如何彻底卸载 Clash Verge？
Windows：通过「设置」→「应用」卸载 Verge，然后手动删除 C:\Users\用户名\.config\clash-verge 文件夹清理残留配置。
macOS：将应用程序拖入废纸篓，并删除 ~/.config/clash-verge 目录。
Linux：使用包管理器卸载，并删除 ~/.config/clash-verge 目录。