WSABuilds 使用指南：在 Windows 上运行安卓子系统的 6 个关键问题

WSABuilds 使用指南：在 Windows 上运行安卓子系统的 6 个关键问题

【免费下载链接】WSABuildsRun Windows Subsystem For Android on your Windows 10 and Windows 11 PC using prebuilt binaries with Google Play Store (MindTheGapps) and/or Magisk or KernelSU (root solutions) built in.项目地址: https://gitcode.com/GitHub_Trending/ws/WSABuilds

WSABuilds 是一套预编译的 Windows Subsystem for Android（WSA）安装包，让 Windows 10 和 11 用户直接装上带 Google Play 商店、Magisk 或 KernelSU root 的安卓子系统，省去从官方渠道拼装配置的麻烦。

我的电脑能不能运行 WSA：系统要求与检查

先说结论：达到下表最低档就能装，推荐档体验更稳。

三项具体检查方法：

1. 按 Win+R 输入optionalfeatures.exe，确认“虚拟机平台”和“Windows Hypervisor 平台”两项已勾选；没勾就勾上、确定并重启。
2. 打开任务管理器，切到性能 → CPU，看“虚拟化”一栏是否为“已启用”；显示已禁用时进 BIOS/UEFI 打开（不同厂商选项名不同，常见为 Virtualization、SVM 或 VT-x）。
3. 右键“此电脑” → 属性，核对系统版本号是否达标。

ReviOS、Tiny11 这类魔改系统可能出现兼容问题，建议用原版系统。

怎样把 WSABuilds 装得最省事

1. 打开仓库 Releases 页，在 Assets 里挑与系统匹配的 .7z 下载。只点“Source code”是拿不到安装包的。
2. 用 7-Zip 或 WinRAR 解压。
3. 把解压得到的文件夹改名为WSA。漏做这一步、或者保留原始长名，脚本最容易出错，是最常见的翻车点。
4. 把文件夹挪到固定位置（如文档目录）。装完后这个文件夹也不能删，WSA 靠其中的文件完成注册和运行。
5. 双击文件夹里的Run.bat，UAC 弹窗点“是”。
6. 如果黑窗口一闪而过、WSA 没装上，改走手动路线：以管理员身份打开 Windows Terminal，切到 WSA 目录后执行：

PowerShell.exe -ExecutionPolicy Bypass -File .\Install.ps1

7. 装完 WSA 会自动拉起，首次运行会弹出诊断数据同意窗，点确定即可（偶尔出现两个一样的窗，都点掉没问题）。回到黑窗口按任意键关闭。

升级旧版本时不必走卸载：把新包里子文件夹的内容整个解压覆盖到旧 WSA 文件夹，提示替换时全部替换，再跑一次Run.bat，数据可以保留。具体对照 升级文档 操作。

装完有哪些选择：版本与 root 组合对比

微软已在 2025 年 3 月 5 日终止 WSA 官方支持，WSABuilds 对 2311.40000.5.0 及之后的版本维持长期支持（LTS）更新。选型主要看两个维度：要不要 Google 服务、要不要 root。

两个取舍要点：

• LTS 节奏慢但稳，日常使用优先选 LTS；非 LTS 更新快，适合想尝新的人。
• OpenGApps 与 MindTheGapps 不能互相替换，混用后 GApps 直接失效，切换前必须完整卸载重装。

WSA 数据丢了怎么办：备份与恢复

先记住风险：完整卸载、或跨大版本重装后，应用和数据会清空。动手前先备份 userdata.vhdx，这是唯一保住数据的文件。

备份就是复制一份文件，位置：

%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\userdata.vhdx

它装着已安装的应用、应用数据和系统设置，拷到 U 盘或其他目录即可。

恢复流程：

1. 卸载现有 WSA。
2. 打开 WSA 文件夹里的Install.ps1，删掉自动启动应用的行（形如Start-Process "wsa://..."，可能是 Play 商店、Magisk 或 Android 设置，视你的版本而定）。
3. 运行安装脚本。黑窗口显示 "Press any key to quit" 时，系统会弹出一串窗口。
4. 这些弹窗先别点、也别关，让它们开着。
5. 打开%LOCALAPPDATA%\Packages，进入（不存在就新建）MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\，把备份的 userdata.vhdx 粘贴进去。
6. 关掉弹窗，启动 WSA，数据应当恢复。

日常小版本升级不走这套流程，覆盖安装就能保住数据。完整说明见 备份与恢复文档。

常见 WSA 故障速查：从现象到解决办法

WSA 打不开或卡黑屏

• 现象：点图标没反应，或窗口弹出即闪退。
• 原因：虚拟化没开启，或缺少虚拟机平台组件。
• 解决办法：先跑Run.bat让它自动启用组件并重启；仍不行就进 BIOS 打开虚拟化后重装。

WSA 内部上不了网

• 现象：系统自带浏览器和应用均无网络。
• 原因：Hyper-V 虚拟网卡驱动与 WSA 网络冲突。
• 解决办法：设备管理器 → 查看 → 显示隐藏设备，把名称带 Hyper-V 的网卡逐一卸载，重启。细节见 网络修复指南。

画面异常、启动失败（Nvidia 显卡居多）

• 现象：应用内花屏撕裂，或 WSA 干脆起不来。
• 原因：当前 GPU 与 WSA 图形渲染不兼容。
• 解决办法：WSA 设置 → 图形与性能，把“用于 Android 应用的 GPU”换成另一块显卡或 Microsoft Basic Renderer，参考 切换 GPU 指南。

Google Play 相关应用崩溃（Windows 11，2025 年 6 月后的构建）

• 现象：GApps 构建的 WSA 启动后崩溃或无响应。
• 原因：已知缺陷，仓库正在修复。
• 解决办法：临时改用文件名带 NoGApps 的构建，或按仓库 README 顶部给出的当前规避方案处理。

adb 连不上 localhost:58526

• 现象：adb 连接命令直接失败。
• 原因：开发者模式未开启，或连接地址已变化。
• 解决办法：在 WSA 设置中开启开发者模式，到开发者页确认 IP，改用adb connect ip:5555。更多问答见 FAQ。

接下来去哪：文档与社区

仓库内文档已按用途分好目录，常用入口：

• 安装：Installation
• 升级：Updating
• 卸载：Uninstallation
• 应用兼容性清单：App Compatibility
• 使用技巧（侧载、换卡、KernelSU 等）：Usage Guides
• 故障文档总索引：Troubleshooting

遇到问题先翻上面这些文档，仍解决不了就到项目 Discord 社区提问，或直接给仓库提 issue。

【免费下载链接】WSABuildsRun Windows Subsystem For Android on your Windows 10 and Windows 11 PC using prebuilt binaries with Google Play Store (MindTheGapps) and/or Magisk or KernelSU (root solutions) built in.项目地址: https://gitcode.com/GitHub_Trending/ws/WSABuilds