v2rayN 桌面版與 WPF 版有何不同：兩種安裝包的選擇建議

先看結論：協定功能基本相同，介面技術不同

v2rayN 桌面版通常是指採用 Avalonia 建構的跨平台圖形介面，WPF 版則採用 Windows Presentation Foundation。兩者都是 v2rayN，用於管理訂閱、節點、系統代理、路由規則與核心程序。安裝包名稱中的 Desktop、Avalonia 或 WPF 描述的是介面實作，不代表 VMess、VLESS、Trojan 等節點類型改用了另一套規則。

真正處理代理連線的是所選用的核心。只要兩個版本使用相同核心、相同節點參數與相同路由設定，連線結果通常一致。若一個版本可用、另一個失敗，應先比較核心版本、設定內容、監聽連接埠與系統代理狀態，而不是只根據介面版本判斷協定相容性。

系統支援與介面差異：只有 Windows 需要二選一

macOS 與 Linux 不需要在 WPF 之間選擇，直接下載符合系統架構的 Avalonia 桌面版即可。Windows 使用者才會同時看到桌面版與 WPF 版。若裝置執行 Windows 10 或 Windows 11，兩種介面通常都可列入考量；接著應核對 x64、arm64 等處理器架構，並確認安裝包是否包含執行環境。

Avalonia 版強調跨平台一致性，同一項功能在不同桌面系統上的選單位置較為接近。WPF 版則更貼近傳統 Windows 視窗行為，例如清單控制項、右鍵選單、系統匣選單與主題呈現可能和桌面版略有不同。這些差異主要影響操作路徑與視覺回饋，不會將同一筆訂閱轉換成不同格式。

介面位置不同時，如何找到功能

不要照抄另一版本的按鈕位置。請依功能名稱尋找，例如訂閱管理、伺服器清單、系統代理、路由設定與核心日誌。常用參數通常可從「設定」→「參數設定」進入；若不同版本的文字略有調整，可在設定視窗中尋找本機監聽連接埠、啟動行為與更新選項。

• 匯入訂閱：儲存訂閱網址後手動執行一次更新，確認節點數量與群組名稱。
• 接管代理：選擇節點並啟動核心後，再開啟系統代理；只啟動核心不代表所有應用程式都已接管。
• 路由分流：先使用預設規則確認連線，再逐步加入網域、IP 或程序規則，方便找出錯誤匹配。
• 檢查日誌：連線失敗時先查看核心啟動資訊，重點檢查連接埠占用、設定欄位與節點參數。

執行環境與安裝包：SelfContained 和相依版如何選擇

同一種介面也可能提供不同的執行方式。名稱含有 SelfContained 的安裝包通常已包含所需的 .NET 執行元件，檔案較大，但更適合未預先安裝相應執行環境的裝置。相依執行環境的安裝包體積較小，啟動時則需要系統已安裝相容的 .NET 執行環境。WPF 版尤其要注意 Windows Desktop Runtime，而 Avalonia 相依版也需要符合發行目標的 .NET 環境。

如果雙擊後沒有視窗，或程序短暫出現後便結束，先不要反覆更換節點。執行環境缺失發生在圖形介面啟動階段，此時訂閱與代理核心尚未開始運作。可先查看系統已安裝的應用程式清單，再依目前安裝包說明補齊相應執行環境；無法確認時，選擇相同架構的 SelfContained 安裝包通常最直接。

架構選錯與執行環境缺失的情況不同

• 架構不相容：程式可能無法啟動，或由系統直接提示此應用程式無法在目前裝置上執行。
• 執行環境缺失：常見情況包括啟動後立即結束、提示需要安裝 .NET，或事件記錄中出現執行環境載入失敗。
• 目錄權限不足：介面可以開啟，但儲存設定、更新核心或寫入日誌失敗。應將完整目錄放在目前帳戶可讀寫的位置。
• 連接埠衝突：介面正常，但核心啟動失敗，日誌明確顯示監聽位址已被占用。此問題與選擇 Avalonia 或 WPF 沒有直接關係。

更新方式與設定遷移：不要直接混用兩個程式目錄

Avalonia 版與 WPF 版可以讀取相近的訂閱與節點資訊，但介面設定、視窗狀態，以及部分版本產生的本機設定結構可能不同。切換版本時，不建議直接將兩個解壓縮目錄覆蓋在一起。這樣容易殘留舊元件或舊設定，最後難以判斷問題來自新版程式還是遺留檔案。

更穩妥的流程是保留舊目錄，使用新目錄啟動目標版本，再重新新增訂閱，或透過用戶端提供的匯出、匯入功能遷移必要資料。完成遷移後逐項確認節點、路由與系統代理，不要在首次啟動時同時修改核心、連接埠、DNS 與分流規則。

1. 退出 v2rayN，並確認系統匣圖示與核心程序都已結束。
2. 記錄目前「設定」→「參數設定」中的本機連接埠、系統代理模式、啟動選項與更新方式。
3. 備份訂閱網址、節點備註、路由規則與需要保留的自訂設定。
4. 將新版本解壓縮到獨立目錄，不要覆蓋目前可用的目錄。
5. 首次啟動後只匯入訂閱，選擇一個已知可用的節點進行連線測試。
6. 確認核心日誌正常後開啟系統代理，再恢復路由分流與自訂 DNS 設定。
7. 持續使用一段時間並確認更新功能正常後，再清理舊目錄。

自動更新與手動替換的取捨

若目前版本提供內建更新入口，可在備份重要設定後使用。受到權限、目錄位置或執行環境變更影響時，解壓縮到獨立目錄會更容易回復。更新後應重新檢查系統代理是否處於預期模式，因為程式正常啟動不代表系統代理已開啟。

• 更新前關閉正在執行的核心，避免檔案被占用。
• 不要將 Avalonia 檔案複製到 WPF 目錄，也不要反向混用。
• 更新後檢查訂閱群組數量，確認沒有將測試設定誤當成正式設定。
• 開啟核心日誌，確認監聽位址與「參數設定」中顯示的連接埠一致。
• 終端機工具若使用代理環境變數，需同步確認其連接埠沒有沿用舊值。

依情境選擇：四種常見情況的直接答案

如果仍然無法決定，可以將選擇簡化成一句話：首次安裝優先選 Avalonia 桌面版；長期只使用 Windows 且明確偏好傳統布局，則可繼續使用 WPF 版。已有穩定環境時，沒有必要只因介面名稱就立即遷移，更新前先確認實際要解決的問題。

最終選擇清單

• macOS 或 Linux：選擇 Avalonia 桌面版，並核對處理器架構。
• Windows 首次安裝：優先嘗試 Avalonia 桌面版，執行環境不明確時選擇 SelfContained 類型。
• Windows 傳統介面習慣：選擇 WPF 版，並確認 Windows Desktop Runtime 條件。
• 現有 WPF 環境穩定：繼續使用即可，等確實有跨平台或介面遷移需求時再切換。
• 排查連線問題：先查看核心日誌與實際監聽連接埠，不要只依安裝包名稱判斷。