1. 安裝前：系統需求與 WebView2 執行階段
Clash Verge 的 Windows 用戶端使用 WebView2 來呈現設定介面。系統缺少 WebView2 Runtime 時，應用程式會啟動失敗或顯示空白視窗，這是安裝階段最常見的第一個陷阱。
陷阱 1：WebView2 執行階段缺失
症狀：點兩下應用程式圖示後視窗空白，或跳出缺少 WebView2 Runtime 的提示後閃退。
原因：Windows 11 與 2022 年後的 Windows 10 更新通常已內建 WebView2；較舊的 Windows 10 版本則需要手動安裝。
處理：從 Microsoft 官網下載 WebView2 Runtime 的 x64 離線安裝檔，安裝後重新開啟 Clash Verge，不需要重開機。
系統需求：
- Windows 10 版本 1809（組建 17763）以上，或 Windows 11
- Intel / AMD 裝置選 x64 安裝檔，ARM 裝置選 arm64 安裝檔
- 執行時記憶體占用約 200 MB，4 GB 記憶體即可順暢使用
安裝檔只從官方發布頁下載。第三方下載站的檔案版本舊、來源不明，請不要使用。
2. 安裝 Clash Verge：路徑、權限與服務模式
安裝步驟：
- 執行安裝檔，選擇安裝目錄，勾選「建立桌面捷徑」
- 點擊安裝，等待進度條跑完
- 首次啟動後進入「設定」→「服務模式」，點擊「安裝」
陷阱 2：安裝路徑含中文或空格
症狀：服務模式安裝失敗，或 TUN 模式開啟後無法建立虛擬網卡。
原因：Windows 服務註冊與虛擬網卡驅動對非 ASCII 路徑的支援不完整。
處理：使用預設路徑 C:\Program Files\Clash Verge，或自訂為純英文、不含空格的路徑。已安裝在中文路徑下的，請解除安裝後重新安裝。
陷阱 3：服務模式安裝失敗
症狀：點擊「安裝服務模式」後出現「權限不足」或「安裝失敗」提示。
原因：目前帳號不是系統管理員，或安全軟體攔截了服務註冊行為。
處理：在 Clash Verge 圖示上按右鍵，選擇「以系統管理員身分執行」，再進入「設定」→「服務模式」重試。仍失敗時，暫時關閉安全軟體的系統防護，安裝完成後再重新開啟。
服務模式讓 mihomo 核心以 Windows 服務的方式執行。TUN 模式依賴服務模式，開啟後不需要每次啟動都跳出 UAC 授權視窗，這一步請不要跳過。
3. 匯入訂閱：連結格式與解析失敗排查
在「訂閱」頁點擊「新增」，填寫訂閱名稱，貼上訂閱連結，點擊「確認」。用戶端會抓取連結內容並解析成節點清單。
陷阱 4：訂閱解析失敗
症狀：匯入後出現「解析失敗」「訂閱為空」提示，或節點數為 0。
請依序排查：
- 連結是否過期：用瀏覽器直接開啟訂閱連結。若回傳 401、403 或「已過期」提示，請到機場後台重新產生連結
- 回傳內容是否為 YAML：用瀏覽器開啟後應看到以
proxies:開頭的內容。若回傳 JSON 或 sing-box 格式，請在機場後台切換為 Clash Meta 訂閱格式後重新匯入 - 網路能否連到訂閱網域：部分網路環境無法直接連線訂閱伺服器。先開啟系統代理，再點訂閱卡片上的「更新」重試
訂閱連結格式通常為：
https://example.com/api/v1/client/subscribe?token=xxxxxxxx訂閱連結只在匯入與手動更新時抓取。機場後台更換方案、重設連結後，需要在訂閱卡片上點「更新」重新抓取，節點清單才會更新。
匯入成功後，在「代理」頁選擇節點或策略組。Clash Verge 使用 mihomo 核心，proxy-providers、rule-providers 等 Clash Meta 擴充欄位都能正常解析。
4. 開啟系統代理：連接埠占用與瀏覽器擴充功能
Clash Verge 預設混合連接埠為 7897，同時提供 HTTP 與 SOCKS5 代理。開啟方式：「設定」→「系統代理」→ 開啟開關。系統代理會寫入 Windows「網際網路選項」，讀取系統代理的應用程式都會走代理。
陷阱 5：系統代理已開啟，瀏覽器仍直接連線
原因 1：瀏覽器安裝了 SwitchyOmega 等代理擴充功能，擴充功能接管了代理設定，系統代理被忽略。
原因 2：7897 連接埠被其他程式占用，mihomo 核心啟動失敗。
處理：
- 關閉或移除瀏覽器代理擴充功能，讓瀏覽器跟隨系統代理
- 用命令列檢查連接埠占用：
netstat -ano | findstr 7897 - 輸出非空且處理程序不是 Clash Verge 時，在「設定」→「連接埠」中修改混合連接埠，然後重新啟動應用程式
- 重新啟動瀏覽器，連上 ip.sb 驗證出口 IP
系統代理開關開啟後瀏覽器無法開啟網頁時，請先關掉開關，再依上面兩步排查，不要反覆開關。
5. 切換 TUN 模式：虛擬網卡與 DNS 覆寫
TUN 模式透過虛擬網卡接管系統全部 IP 流量，不依賴應用程式主動讀取代理設定。命令列工具、遊戲、UDP 應用程式在系統代理模式下經常漏掉，切到 TUN 模式後都會被接管。
開啟條件：服務模式已安裝。開啟方式：「設定」→「TUN 模式」→ 開啟開關。首次開啟時 Windows 會跳出虛擬網卡安裝提示，請點「允許」。
陷阱 6：TUN 模式開啟後立刻關閉
原因 1：服務模式未安裝或安裝失敗。
原因 2：虛擬網卡驅動被安全軟體隔離。
處理：
- 確認「設定」→「服務模式」顯示「已安裝」
- 開啟「裝置管理員」→「網路介面卡」，確認存在 Clash Verge 虛擬網卡
- 在安全軟體隔離區還原被攔截的驅動檔案，重新啟動 Clash Verge
TUN 模式開啟後，系統代理開關可以保留也可以關閉。兩者同時開啟時，瀏覽器走系統代理，其餘流量走虛擬網卡，互不衝突。
TUN 模式下建議同時開啟 DNS 覆寫：「設定」→「DNS 覆寫」→ 開啟 Fake-IP。mihomo 接管 DNS 解析，避免部分應用程式的 DNS 請求繞過代理造成洩漏。mihomo 預設 Fake-IP 網段為 198.18.0.1/16，不需要手動修改。
6. 服務模式、開機自動啟動與防火牆
服務模式安裝完成後，Clash Verge 以系統服務執行，開機自動啟動不受使用者登入影響。
開機自動啟動：「設定」→「開機自動啟動」→ 開啟開關。開機後代理未生效時，請檢查工作管理員的「啟動」頁，確認 Clash Verge 沒有被停用。
陷阱 7：防火牆攔截
症狀：開啟 TUN 模式後，部分應用程式無法連線網路；Windows 資訊安全中心跳出「是否允許存取」提示。
處理：
- 彈出視窗出現時，勾選「私人網路」和「公用網路」，點擊「允許存取」
- 已誤按取消時，進入「Windows 資訊安全中心」→「防火牆與網路保護」→「允許應用程式通過防火牆」，手動加入 Clash Verge
- 清單中找不到時，點擊「允許其他應用程式」，定位到安裝目錄下的 Clash Verge 執行檔
7. 七個陷阱速查表
| 陷阱 | 症狀 | 處理 |
|---|---|---|
| 1 WebView2 缺失 | 視窗空白、啟動閃退 | 安裝 WebView2 Runtime |
| 2 路徑含中文 | 服務模式或 TUN 安裝失敗 | 改用純英文路徑重新安裝 |
| 3 服務模式失敗 | 出現權限不足提示 | 以系統管理員身分執行後重試 |
| 4 訂閱解析失敗 | 匯入後節點為 0 | 檢查連結有效期與訂閱格式 |
| 5 系統代理不生效 | 瀏覽器仍直接連線 | 關代理擴充功能、查 7897 連接埠 |
| 6 TUN 開啟即斷 | 開關自動彈回 | 先裝服務模式、檢查虛擬網卡 |
| 7 防火牆攔截 | 部分應用程式連不上 | 允許私人與公用網路 |
8. 設定完成後的驗證清單
- 系統代理生效：連上 ip.sb，出口 IP 與節點地區一致
- TUN 生效：開啟命令提示字元，執行
curl -I https://www.google.com，回傳 HTTP/2 200 即正常 - 訂閱可更新：在訂閱卡片點「更新」，沒有報錯
- 開機自動啟動：重新啟動電腦，不手動開啟應用程式也能正常連網
7 個陷阱逐一確認完，Windows 端設定就算完成。後續遇到策略組選擇或規則比對問題，可以繼續查看使用文件。