先按操作系统筛选，再按使用习惯选择。Avalonia 桌面版面向 Windows、macOS、Linux；WPF 版面向 Windows。两者的界面框架不等于代理内核，切换界面也不会自动改善节点速度。本文说明平台、功能与迁移检查项，适合正在选安装包、从经典界面迁移，或需要在不同桌面系统使用 v2rayN 的用户。
先分清界面框架与代理内核
Avalonia 和 WPF 负责窗口、菜单、节点列表等桌面界面。WPF 是面向 Windows 的桌面界面技术；Avalonia 支持跨平台界面。它们不是 VMess、VLESS 这样的代理协议，也不是 V2Ray 或 Xray 这样的代理内核。看到安装入口标注 Avalonia，不代表订阅需要换成另一种格式。
v2rayN 负责管理服务器配置、订阅和运行参数，再调用相应内核处理连接。能否使用某种协议及其传输选项，要同时看当前 v2rayN 版本的配置支持和所选内核的能力。不要仅凭界面外观判断协议兼容性，也不要把两套界面当作两条不同的网络线路。
按 Windows、macOS、Linux 选择
先确认操作系统与处理器架构。Windows 用户打开「设置」→「系统」→「系统信息」，查看“系统类型”，区分 x64 与 ARM64。macOS 用户查看“关于本机”中的芯片信息；Linux 用户可运行 uname -m 查看架构。框架选对但架构选错，安装或启动仍可能失败。
Avalonia 桌面版
推荐作为跨平台使用的优先入口。在 Windows、macOS、Linux 间切换时，可沿用相近的节点管理思路；仍需分别选择对应系统和架构的发布包。
适合：首次选型、跨系统办公、希望熟悉同一套桌面界面的用户。
WPF 版
作为 Windows 经典界面的选择。已有稳定工作流时，可先保留原有使用方式，再评估是否迁移；不能把 Windows 版程序直接用于其他桌面系统。
适合：主要使用 Windows、熟悉经典操作布局、已有配置需要延续的用户。
Windows 11 用户不必因为系统较新就排除 WPF。反过来，WPF 也不代表更适合所有旧系统：目标系统是否受支持，还受具体发布包、运行时和内核要求影响。下载前查看发布入口说明，不要从框架名称推断最低系统版本。
macOS 和 Linux 用户应选对应平台的 Avalonia 包。Linux 还要确认发行版的包格式及桌面依赖；能显示窗口只说明界面已启动，不代表系统代理、托盘和 TUN 权限也已配置完成。
比较界面、功能与网络表现
两套界面可能在列表密度、设置窗口布局、快捷键和托盘交互上存在差异。高分屏是否清晰、缩放后按钮是否完整，需要结合系统缩放比例和具体版本检查。不要把一次显示异常直接归因于整个框架，也不要假定两套界面的每个按钮都在相同位置。
| 检查项 | Avalonia 桌面版 | WPF 版 |
|---|---|---|
| 系统入口 | 按 Windows、macOS、Linux 分别选包 | 选择 Windows 对应架构的包 |
| 订阅管理 | 核对订阅分组、更新入口及导入结果 | 核对已有分组与当前更新设置 |
| 协议配置 | 由客户端配置支持与内核能力共同决定 | 同样需要核对客户端和内核版本 |
| 系统集成 | 分别验证各系统的代理、托盘和权限 | 验证 Windows 系统代理与托盘操作 |
| 性能判断 | 区分界面资源占用与内核流量处理 | 采用相同节点与测试条件再比较 |
订阅导入、服务器选择、系统代理和路由分流是选型时应逐一验证的工作流，不宜理解为两个版本永久完全一致的功能清单。新选项的入口、配置字段和实现进度可能不同。若某项设置找不到，先检查当前版本的设置页与说明，再决定是否换版。
- 比较界面占用：退出另一实例，使用相同节点数量，在 Windows 任务管理器中分别查看界面进程和内核进程，避免把两者混为一个指标。
- 比较网络体验：保持节点、内核、路由规则、DNS 和测试目标一致。节点负载或线路变化会掩盖界面差异。
- 检查 TUN：单独验证所需权限、内核与路由行为。TUN 不只是一个界面开关，也不能仅凭开关亮起就认定全部流量都按预期处理。
迁移配置：先备份，再逐项验证
迁移的重点是复现可用配置，不是把新程序覆盖到旧目录。先完全退出旧实例，使用当前版本提供的备份或导出入口保存配置；便携目录也应在退出后另存一份。配置可能包含订阅地址、服务器凭据及使用记录，应保存在受控位置。
迁移方案：隔离验证与保留回退
新版本验证
- 使用独立程序目录，并确认没有共用同一份活动配置。
- 先导入一个已知可用节点，再补齐订阅分组。
- 核对监听端口、内核选择、路由与 DNS。
- 先验证普通系统代理，再按需要测试 TUN。
旧版本回退
- 保留退出后的配置备份与原程序目录。
- 测试期间停用旧实例的开机启动。
- 不要让两套客户端同时改写系统代理。
- 回退前退出新实例，再恢复原有代理设置。
独立程序目录不一定代表独立数据目录；若两版共用用户配置位置，应顺序测试，并在切换前保留备份。
- 记录原配置。在「设置」→「参数设置」核对本地监听端口；记录当前服务器、路由选择和系统代理状态。菜单名称不同时，按对应功能查找。
- 重新建立订阅。进入「订阅分组」→「订阅分组设置」，添加原订阅地址并保存，再执行更新。订阅只负责提供服务器数据，不会自动搬迁所有本地 DNS、热键和路由设置。
- 检查端口冲突。若原实例监听
10808，先退出它再测试新实例。必须并行诊断时，可将新实例改为未被占用的端口，例如10818，并同步修改手动填写的应用代理地址。 - 恢复实际工作流。选择活动服务器，通过「系统代理」菜单设置所需状态。逐个测试浏览器、开发工具和其他应用，不要只检查节点延迟测试结果。
- 最后启用常驻项。连接、休眠恢复和重启测试通过后，再启用新实例的开机启动，避免旧实例下次登录时重新接管代理。
不要默认两套界面的内部数据库或配置文件可以直接互换。只有当前版本明确支持的导入、恢复方式才适合用于整体迁移；跨版本恢复失败时，先用订阅和节点重新建立最小可用配置，再逐项恢复本地规则。
排查换版后无法联网的问题
换版后“节点还在但打不开网页”，通常需要检查代理入口，而不是马上更换框架。先确认客户端已启动内核，再核对系统代理与应用手动代理。系统代理只对读取该设置的应用起作用，不能据此推断所有程序都已被接管。
Windows 上可用下面的命令查找示例端口的监听进程。没有输出时，回到客户端查看实际端口和启动日志；有输出时，核对 PID 是否属于预期实例。只有确认进程用途后，才考虑退出占用程序。
netstat -ano | findstr LISTENING | findstr :10808
tasklist /FI "PID eq 4321"- 浏览器能用，其他程序不能用：检查目标程序是否读取系统代理；支持手动代理的程序应填写实际地址和端口，其他接管需求再评估 TUN。
- 域名失败，直接连接表现不同：核对新实例的 DNS 和路由配置，注意直连与代理解析路径，不要用关闭安全检查来掩盖错误。
- 关闭窗口后断网：检查关闭动作是否退出了客户端，随后查看系统代理是否仍指向已经停止的本地端口。
需要继续梳理模式差异时，可查看系统代理模式说明；需要全局接管时，再对照TUN 设置检查权限与路由。两项应分开验证，避免同时改动过多参数而难以定位原因。
版本选择常见问题
Windows 11 第一次使用，选哪套界面？
可以先选 Avalonia 桌面版，按系统架构获取对应包，再完成订阅导入与系统代理验证。若已有明确依赖的经典界面操作习惯，也可以选择 WPF 版；先确认实际功能，不必为了框架名称反复迁移。
从 WPF 换到 Avalonia，要重新购买订阅吗？
界面切换本身不要求重新购买订阅。打开「订阅分组」→「订阅分组设置」，使用原服务提供的有效地址导入。能否多设备使用、是否限制同时在线，要以订阅服务的账户规则为准。
换界面能让同一个节点变快吗？
不能仅凭界面框架作此判断。先在相同节点、相同内核和相同路由下测试，核对两边的 DNS 与代理模式。若配置不同，观察到的差异不能直接归因于 Avalonia 或 WPF。
两个版本能放在同一台电脑吗？
可以保留用于回退，但先确认数据位置并做好备份。日常只运行一套；测试时避免争用同一监听端口，并确保只有一个实例负责系统代理和 TUN。测试结束后核对开机启动项。
macOS 或 Linux 上找不到和教程一样的菜单怎么办？
先确认教程对应的界面和版本。按“订阅分组、参数设置、系统代理、路由设置”等功能查找，不要照搬 Windows 的系统操作路径。桌面环境的托盘支持与代理生效方式也要单独检查。
v2rayN 客户端下载
按系统与架构选择安装入口，再按教程完成订阅导入和代理验证。