疑難排解
常見報錯速查手冊
收藏這一頁。左邊是你看到的報錯，右邊是原因和解法，需要展開的都給了詳細教程連結。
啟動與介面
| 現象 / 報錯 | 原因與處理 |
|---|---|
| 視窗白屏、介面空白 | WebView2 執行時缺失或損壞。裝 Evergreen 執行時或改用 fixed_webview2 安裝包，見 Windows 安裝 |
| SmartScreen「已保護你的電腦」 | 未簽名開源軟體的正常提示，更多資訊 → 仍要執行。前提是從官方來源下載，見辨別官方包 |
| macOS「已損壞，無法開啟」 | Gatekeeper 隔離標記，執行 xattr 命令移除，見 macOS 安裝 |
| 開機沒有自動啟動 | 啟動項被系統或安全軟體禁用，見自啟設定 |
核心與設定
| 現象 / 報錯 | 原因與處理 |
|---|---|
Port xxxx is already in use | 埠被其他程式佔用，見埠衝突 |
yaml: unmarshal errors / 設定載入失敗 | YAML 語法錯誤，通常是 Merge 縮排問題，見擴充套件設定 |
unsupported proxy type | 核心版本不認識訂閱裡的新協議，升級/切換核心 |
rule-provider ... initial error | 規則集拉取失敗或 behavior 型別寫錯，見規則集 |
| 核心頻繁崩潰重啟 | 先切回穩定版核心；仍崩則清空 Merge/Script 逐段排查 |
網路功能
| 現象 / 報錯 | 原因與處理 |
|---|---|
| TUN 開關灰色 / 開啟報錯 | 服務模式未安裝或損壞，見服務修復 |
| 訂閱更新 401/403/超時 | 訂閱失效或域名被阻斷，見訂閱排查 |
| 代理開著但無法上網 | 五步排查法，見完整清單 |
| UWP 應用斷網 | 迴環限制，見 UWP 豁免 |
提示
表裡沒有的報錯，把「日誌」頁裡的原文（英文部分）複製去 GitHub 倉庫的 Issues 搜尋，大機率已有現成答案。
還沒有安裝 Clash Verge？
下載 v2.5.1Windows 64 位安裝包 · v2.5.1 · 免費開源