适用范围：Clash Verge (Rev) 在 Windows / macOS / Linux 启动闪退、空白、卡 Loading、端口被占用等问题。
🚀 快速三步
- 重命名配置目录后重新启动（验证是否配置损坏）。
- 换最新版或回退到上一个稳定版本。
- 查看日志（Verge → 日志面板 / 系统事件查看器 / Console）。
📁 配置目录位置
| 平台 | 路径 |
|---|
| Windows | %USERPROFILE%\.config\clash-verge |
| macOS | ~/Library/Application Support/clash-verge |
| Linux | ~/.config/clash-verge |
重命名示例：
Rename-Item "$env:USERPROFILE\.config\clash-verge" clash-verge.bak-$(Get-Date -Format yyyyMMddHHmm)
🪟 Windows 专项
| 现象 | 处理 |
|---|
| 启动即退出 | 安装 VC++ 运行库 (2015-2022) + .NET Desktop Runtime 8.x |
| 端口占用 (7890/7897) | `netstat -ano |
| 无法写入 TUN 驱动 | 以管理员启动 / 关闭安全软件拦截 |
| 长时间白屏 | 删除 Cache 目录；显卡驱动更新 |
| Service Mode 失败 | 重新安装服务：设置 → 服务管理 → 重装 |
🍎 macOS 专项
| 现象 | 处理 |
|---|
| 无法创建网络扩展 | 系统设置 → 网络 → 允许代理扩展；重新勾选 |
| 启动闪退 | `log show –last 1m |
| 图标常驻但无窗口 | 删除配置目录后重启；确认未被多显示器隐藏 |
| 代理不生效 | 重新授权“完全磁盘访问” (若开启增强) + 关闭其它代理软件 |
🐧 Linux 专项
| 现象 | 处理 |
|---|
| Wayland 界面异常 | 用 XDG_SESSION_TYPE=x11 再运行或切换到 Xorg 会话 |
| 权限不足 | chmod +x 可执行；确保用户对配置目录有写权限 |
| 缺少依赖 | 安装 libnss3 libatk1.0-0 libdrm2 libgbm1 等浏览器类依赖 |
🧪 通用排查
- 关闭其它同类代理 / VPN 软件（端口 / TUN 冲突）。
- 核对系统时间同步（TLS 握手错误常见）。
- 检查是否残留旧内核：更新内核或清除
core 文件缓存。 - 订阅转换失败导致空配置：尝试导入最小化测试 YAML。
🧹 深度重置
- 备份
profiles / 自定义规则文件。 - 删除配置目录。
- 全新解压/安装最新版。
- 只导入 1 条订阅 → 验证 → 再逐步恢复其它。
🪵 收集日志
| 平台 | 方法 |
|---|
| Windows | 事件查看器 → Windows 日志 → 应用；或启动命令行附加 --debug |
| macOS | Console.app 过滤 clash；log show --predicate 'process contains "clash"' --last 5m |
| Linux | 终端运行 ./Clash-Verge --debug 查看输出 |
🎯 典型错误映射
| 日志/提示 | 原因 | 解决 |
|---|
| listen tcp 0.0.0.0:7890: bind | 端口已占用 | 改端口或结束冲突进程 |
| dial tcp timeout | 节点连接性差 | 换节点 / 网络环境 |
| rule parse error | 规则语法错误 | 用在线 YAML 校验 & 修正缩进 |
| failed to open TUN | TUN 权限 / 驱动问题 | 提权 / 重装驱动 |
| websocket close 1006 | 内核崩溃或网络断 | 更新内核 / 检查防火墙 |
🔁 最终决策流程
配置损坏? → 重命名目录 → 成功=导入逐步排除；失败 → 安装依赖 / 运行库 → 仍失败=收集日志提问。
提问示例模板：
平台：Windows 11 23H2
版本：Clash Verge 2.x
表现：启动 1s 后退出
已尝试：重置配置 / 关闭杀软
日志片段：listen tcp 0.0.0.0:7890: bind
提供这些信息可让响应速度提升数倍。