第一次安裝，可先依作業系統與處理器架構選擇 Avalonia 桌面版；若已在 Windows 上穩定使用 WPF 版，不必只為了介面改版而遷移。本文說明介面框架、代理核心與系統接管方式的差異，整理兩版適用情境、相依項目檢查方法，以及保留原設定進行比較測試的建議步驟。
一、Avalonia 與 WPF 改變的是哪個部分
Avalonia 是跨平台的 .NET 使用者介面框架；WPF 全名為 Windows Presentation Foundation，是專為 Windows 設計的桌面介面框架。在 v2rayN 中，這兩個名稱主要代表視窗、清單、選單與操作方式的實作，不是兩種代理協定，也不是兩種節點方案。
v2rayN 負責管理伺服器設定、訂閱、路由與核心程序；實際處理協定連線的是所選用的核心。VMess、VLESS 等協定能否使用，取決於節點設定、所選核心及其版本是否相容。不能因為看到「Avalonia」就認定節點速度較快，也不能看到「WPF」就認為只能連線舊協定。
| 層次 | 負責項目 | 檢查位置或內容 |
|---|---|---|
| 介面框架 | 視窗、字型、選單、清單操作 | 下載頁的桌面版或經典 WPF 版 |
| 代理核心 | 協定交握、傳輸、路由規則執行 | 用戶端的核心選擇、啟動記錄與核心版本 |
| 節點設定 | 伺服器位址、連接埠、驗證與傳輸參數 | 伺服器編輯視窗與訂閱匯入結果 |
| 流量接管 | 將應用程式的連線送進本機代理 | 系統代理、應用程式內代理或 TUN 設定 |
例如，瀏覽器能否透過本機 HTTP 代理瀏覽網頁，取決於核心是否啟動，也取決於瀏覽器是否使用正確的連接埠。介面樣式變更不會自動修正連接埠設定錯誤。排查時先確認問題屬於哪個層次，比反覆更換介面版本有效。
二、依平台與使用習慣選擇版本
建議依「作業系統 → 處理器架構 → 介面版本」的順序下載。Windows 使用者可選擇兩種介面；macOS、Linux 使用者則應下載對應平台的 Avalonia 桌面版，Windows 的 WPF 程式無法直接複製到其他平台執行。
Avalonia 桌面版
推薦適合作為初次安裝的選擇。依 Windows、macOS 或 Linux 下載相應版本，在不同桌面系統上也能使用相近的設定管理流程；實際支援的架構請以下載頁提供的選項為準。
適合：初次安裝、跨系統使用，或希望維持一致操作習慣的使用者。
經典 WPF 版
適用於 Windows。若已熟悉現有的節點清單、系統匣選單與設定位置，且目前使用正常，可以繼續使用；此版本並非 macOS 或 Linux 的相容方案。
適合：在 Windows 上已有穩定設定，並希望保留原有操作習慣的使用者。
處理器架構也要另外確認。Windows 可在「設定」→「系統」→「系統資訊」查看「系統類型」；macOS 可從蘋果選單的「關於這台 Mac」查看晶片；Linux 可用下方指令查看機器架構。輸出 x86_64 通常對應 x64，aarch64 通常對應 ARM64。若選錯架構，請先更換安裝套件，而不是調整訂閱。
uname -m結論：先確認平台相符，再比較介面
macOS、Linux 使用者請直接選擇對應平台的 Avalonia 套件；Windows 初次安裝可先選桌面版。若現有 WPF 環境運作穩定，建議保留原版，先在獨立資料夾測試新版，再決定是否遷移。
三、如何檢查介面差異與系統相依性
兩版的選單安排、對話方塊配置、字型呈現與系統匣操作可能不同。熟悉某張教學截圖，不代表另一版缺少相同功能。尋找設定時，請以功能名稱為線索，例如訂閱群組、系統代理、本機監聽連接埠與路由設定，不要只憑按鈕顏色或視窗位置判斷。
安裝前檢查：Windows 與跨平台環境
Windows：先確認發行套件的相依項目
- 分清楚安裝程式與免安裝壓縮包；使用壓縮包時，請完整解壓縮，不要只複製主程式。
- 若出現缺少 .NET 的提示，請記下提示中的執行階段名稱、主要版本與架構。
- WPF 程式可能需要相符的 .NET Desktop Runtime；一般執行階段或開發工具不一定能取代。
- 若套件已內含執行階段，不要只因另一版需要相依項目，就重複安裝無關的執行階段。
macOS、Linux：再確認系統整合條件
- 確認套件與處理器架構相符，並依目前發行套件的說明啟動。
- macOS 首次開啟時若遭系統封鎖，請先確認檔案來源，再查看「系統設定」→「隱私權與安全性」。
- Linux 使用者請留意發行版的圖形相依項目、桌面環境與系統匣支援；視窗能啟動與系統匣能顯示是兩回事。
- 系統代理與 TUN 的權限需求不同，請勿混淆啟動介面的條件與網路接管權限。
結論：需要哪些相依項目，應依目前套件說明與實際錯誤訊息判斷，不能只憑「Avalonia」或「WPF」推測。
若主視窗能開啟，但啟動核心時立即出錯，請先檢查記錄中的執行檔路徑、權限與連接埠占用資訊。反之，若點兩下後連視窗都沒有出現，應優先確認套件是否完整解壓縮，以及執行階段是否相符。這兩種問題的排查方向不同，重新匯入訂閱通常無法解決介面啟動失敗。
四、保留設定並遷移的建議步驟
兩版都能管理訂閱，不代表任意版本的設定資料夾都能直接覆蓋。用戶端設定可能包含資料庫結構、核心路徑與平台相關選項；新版寫入資料後，舊版未必能照原樣讀取。較穩妥的做法是先完整備份，再遷移通用設定，最後確認系統接管選項。
- 記錄舊環境。記下用戶端版本、核心名稱與版本，並記錄目前的伺服器、路由模式、監聽位址與連接埠。訂閱網址屬於敏感資訊，備份時不要放進公開截圖或共用文件。
- 先備份，再試用。結束舊用戶端，確認系統匣中的程序已停止，再備份實際使用的設定資料夾。將新版放在另一個資料夾，不要直接覆蓋舊程式檔案。
- 優先匯入通用設定。在新版的「訂閱群組」→「訂閱群組設定」中確認群組與網址，再更新訂閱；選單名稱可能因版本而異。手動新增的節點可使用用戶端提供的匯出與匯入功能，避免逐項重新輸入驗證參數。
- 確認連接埠與路由。前往「設定」→「參數設定」檢查本機監聽相關項目，並重新確認路由、DNS 與核心選擇。不要假設新安裝會自動沿用舊版的所有選項。
- 一次只讓一個執行個體接管網路。先透過應用程式內代理測試本機監聽，再從系統匣的「系統代理」選單選擇「自動設定系統代理」。測試完成後，請保持另一版關閉，避免兩個程序輪流改寫系統設定。
切換完成後，請使用相同的目標網址驗證代理連線。例如將測試請求送至 https://example.com，查看用戶端記錄是否出現相應請求，再確認路由選擇是否符合預期。網頁能開啟只代表這次請求成功，不表示所有應用程式都已交由系統代理或 TUN 接管。
五、如何公平比較速度、記憶體與功能
「Avalonia 和 WPF 哪個比較快」至少包含兩個問題：視窗操作是否流暢，以及代理連線是否穩定。前者與介面繪製、清單規模及桌面環境有關；後者主要受節點線路、核心設定、DNS、路由與網路狀況影響。不能只憑一次網頁載入結果，就對介面框架下結論。
- 固定網路條件：在同一台電腦與同一個網路環境中，使用相同節點、傳輸設定、核心版本與路由規則，避免把線路變化誤認為版本差異。
- 分開記錄介面與網路表現：介面測試記錄啟動至可操作所需時間，以及篩選節點時是否卡頓；網路測試則記錄相同目標是否連線成功及相關記錄。
- 記憶體統計要包含核心：在工作管理工具中同時觀察介面程序與其啟動的核心程序。只看主視窗程序，容易漏算實際資源用量。
- 重複驗證：每個版本可在相同條件下測試 3 次，記錄結果範圍，不要只挑最好的一次。此處建議的是測試次數，不代表本站的效能實測結果。
若只有 TUN 模式失敗，而應用程式內的 HTTP 代理正常，請優先檢查權限、路由與 DNS，不要直接歸因於介面框架。系統代理主要影響遵循系統代理設定的應用程式；TUN 則涉及虛擬網路介面與路由接管，兩者並非同一個開關的不同名稱。
六、版本選擇常見問題
Windows 上的 WPF 版用得正常，還需要更換嗎？
不必只因介面名稱不同就遷移。先確認是否有實際需求，例如跨系統使用，或某項操作在桌面版更順手。若要試用，請先備份舊資料夾並關閉舊執行個體，再於獨立資料夾啟動新版，避免直接覆蓋後難以復原。
換成 Avalonia 後，原本的訂閱還能使用嗎？
通常可以重新新增訂閱，但匯入結果取決於訂閱格式與目前版本的支援情況。先確認「訂閱群組」中的網址，再更新訂閱；若節點數量或欄位有所不同，請查看更新記錄與節點編輯視窗，不要直接覆蓋舊資料庫來掩蓋匯入問題。
新版已開啟，為什麼瀏覽器還是連不上？
先確認已選取可用伺服器，且核心成功啟動，再核對本機監聽連接埠。若使用範例連接埠 10808，應用程式內代理的設定必須與用戶端監聽設定一致。最後確認系統匣的「系統代理」已設為「自動設定系統代理」，並排除仍有另一個執行個體正在修改系統代理。
出現 .NET 錯誤時，隨便安裝一個執行階段就可以嗎？
應依錯誤提示安裝符合需求的執行階段種類、主要版本與架構。WPF 所需的桌面執行階段不能直接視為一般執行階段；請先閱讀目前套件的相依項目說明，安裝後重新啟動用戶端，再確認原本的錯誤是否消失。
改用另一種介面版本，能解決 VLESS 節點連線失敗嗎？
不一定。請先比對兩邊的核心版本、伺服器連接埠、TLS、SNI 與傳輸參數；若節點使用 Reality，也要確認相應的驗證參數。只有在設定相同，且確認問題與特定用戶端實作有關時，才值得將版本差異列為排查方向。
最後的選擇不必複雜：平台與架構相符、相依項目齊全、常用功能正常，且能安全保留原有設定即可。介面版本影響的是操作方式，連線品質仍需逐項檢查核心、節點與本機網路設定。