WSABuilds 安装完整指南：在 Windows 10/11 上跑起带 Root 的 Android 子系统-平芜编程栈

WSABuilds 安装完整指南：在 Windows 10/11 上跑起带 Root 的 Android 子系统

【免费下载链接】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

WSA 安装一次成功，靠的是把前置条件检查清楚、构建包选对。WSABuilds 提供预构建包（prebuilt binaries），让你在 Windows 10 和 Windows 11 上直接运行 Android 子系统，内置 Google Play 商店（MindTheGapps）与 Magisk 或 KernelSU 两种 root 方案，省去自己编译打补丁的麻烦。微软官方 WSA 已于 2025 年 3 月 5 日停止支持，而这套开源构建会持续维护，本文带你完成一次完整的 WSABuilds 安装：从下载、注册包、验证桌面可用，到 GPU 切换、APK 侧载和常见报错处理。

[!IMPORTANT] 2025 年 6 月之后的构建中，包含 GApps 的版本在部分 Windows 11 机器上存在 Google Play 服务崩溃问题（见项目 README 顶部的官方说明）。不需要 Play 商店的用户，建议直接选文件名带NoGApps的构建，可绕开该问题。

安装前自检：这 5 项过不了就别往下走

检查项	你的状态	最短处理指引
CPU 虚拟化（VT-x / AMD-V）	✅ 已开启 / ❌ BIOS 里没开	重启进 BIOS/UEFI 打开虚拟化，各品牌机型入口不同，网上搜"你的机型 + 开启虚拟化"即可
Windows 功能	✅ 已勾选 / ❌ 未勾选	按`Win + R`输入`OptionalFeatures.exe`，勾选"虚拟机平台"和"Windows 虚拟机监控程序平台"，应用后按提示重启
官方商店版 WSA	✅ 未安装 / ❌ 已安装	官方版本必须完全卸载（设置 → 应用 → 添加和功能里删除，或参考 Uninstallation.md），否则无法注册本构建
磁盘空间与分区	✅ 充足 / ❌ 不足	系统盘（C 盘）至少 10GB 空闲，且必须是 NTFS 分区（exFAT 不行）
系统版本	✅ 达标 / ❌ 过低	Windows 11 需 Build 22000.526 以上；Windows 10 需 22H2（10.0.19045.2311 以上）。`Win + R`输入`winver`查看

[!NOTE] 如果你要重装并希望保留旧的应用与数据，先备份%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\userdata.vhdx，安装完成后再放回原位置。详细流程见 Backup and Restore.md。

获取构建包：下对版本再动手

打开仓库 Releases 发布页，找到最新的构建版本（如 Windows 11 x64 的Windows_11_2407.40000.4.0_LTS_7_HOTFIX_1）。
在 Assets 列表下载.7z归档。注意选对 CPU 架构（x64 还是 arm64），并不要下载 "Source code"。
按构建名挑功能组合：MindTheGapps表示内置 Play 商店，NoGApps表示没有，带Magisk表示内置 Magisk root。
如果你只想先查文档不装软件，也可以克隆仓库浏览：

git clone https://gitcode.com/GitHub_Trending/ws/WSABuilds

完成安装：从 Run.bat 到按任意键退出

解压.7z归档，把解压出来的文件夹重命名为WSA。
删除.7z压缩包，把WSA文件夹移动到一个你愿意长期保留的位置（文档文件夹是官方推荐的位置）。
如果之前装过 MagiskOnWSA：直接合并进旧文件夹，提示替换时选择全部替换，旧版会被自动卸载且用户数据保留。
进入WSA文件夹，找到并双击Run.bat，等待 PowerShell 窗口弹出安装过程。
窗口如果一闪而过、没请求管理员权限，且 WSA 没有装好：按Win + X打开 Windows 终端（管理员），输入以下两条命令，把{解压路径}换成你的WSA文件夹实际位置（含引号）：

cd "{解压路径}" PowerShell.exe -ExecutionPolicy Bypass -File .\Install.ps1

看到 PowerShell 提示 "Press any key to quit" 时，点击该窗口按一下任意键关闭窗口，然后关掉文件资源管理器。

验证安装是否成功

安装完成后 WSA 会自动启动；首次安装会先弹出"同意诊断信息"窗口，有时出现两个一模一样的窗口，点"确定"即可，不会出任何问题。
确认 Android 桌面（启动器）正常显示，没有卡在黑屏或启动画面。
打开应用列表，看到 Google Play 商店（GApps 构建）或 Magisk 管理器，点开能正常加载。
以上都通过，安装就算成功；如果某一步卡住，直接对照下面"排障速查"。

[!NOTE] 这个WSA安装文件夹之后不能删。安装本质是向系统注册一个"引用了文件夹内文件的 appx 包"，删掉它等于拆掉 WSA 本体。

进阶玩法：装好之后值得做的三件事

切换 GPU，改善游戏与图形表现

能干什么：指定 WSA 使用某块显卡渲染，绕开个别显卡导致的黑屏、闪退问题（Nvidia 显卡、Intel HD 530 及更早的核显容易踩坑）。
怎么操作：打开 WSA 设置 → "图形和性能"（Graphics and Performance）→ 选择"用于 Android 应用的 GPU"。完整图解见 ChangingGPU.md。
适合谁：WSA 启动异常、图形错乱，或想手动指定独显/核显的用户。

侧载 APK：装任意 Android 应用

能干什么：不依赖 Play 商店，把 Windows 里的 APK 文件装进 WSA。
怎么操作：Sideloading.md 列了五种方式：Play 商店直接下载、WSA Files 浏览器应用、WSA-Sideloader、WSA Pacman、ADB 命令行，挑顺手的用即可。
适合谁：需要装无商店渠道应用、或者用的是 NoGApps 构建的用户。

KernelSU 替代 Magisk，以及顺手装个 BusyBox

能干什么：Magisk 构建上出现模块丢失等不稳定问题时，换用稳定性更好的 KernelSU root；顺手装 BusyBox 获得完整 Unix 命令行工具集。
怎么操作：下载 KernelSU Manager 的 apk 后侧载进 WSA（见 KernelSU.md）；BusyBox 则下载对应 Magisk 模块 zip，用 Magisk 管理器安装即可（见 BusyBox.md）。
适合谁：对 root 稳定性有要求、或习惯在 Android 上敲命令线的用户。

排障速查：安装和启动失败先看这 4 条

现象	原因	处理
`Run.bat`双击后窗口闪退，没弹管理员授权	脚本权限不足或未生效	按上节第 5 步，手动以管理员身份运行`Install.ps1`；若仍失败，说明当前 PC 不被 WSA 支持
注册 appx 包失败	包注册过程报 ActivityID 错误	管理员 PowerShell 进入`WSA`目录运行`Add-AppxPackage -ForceApplicationShutdown -ForceUpdateFromAnyVersion -Register .\AppxManifest.xml`，记下输出的 ActivityID（UUID），再运行`Get-AppPackageLog -ActivityID <uuid>`查看失败日志定位原因
WSA 黑屏、闪退或图形错乱	当前 GPU 不兼容（Nvidia 卡与老核显常见）	按 ChangingGPU.md 换一块显卡或 Microsoft Basic Renderer
装完后应用集体闪退 / 卡启动画面	2025 年 6 月后 GApps 构建在部分 Win11 机器上的已知问题	改用文件名带`NoGApps`的构建重装，或按 README 顶部提示的临时方案处理