WSABuilds 实用完整指南：在 Windows 上安装带 Play 商店与 Root 的 WSA（避坑版）-开发者社区

WSABuilds 实用完整指南：在 Windows 上安装带 Play 商店与 Root 的 WSA（避坑版）

【免费下载链接】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）方案，把 Google Play 商店（基于 MindTheGapps）和 Magisk / KernelSU 这类 root 方案直接打包进 WSA 安装包里。你不需要自己折腾构建脚本，下载对应 Windows 版本和 CPU 架构的 .7z 压缩包，解压后运行安装脚本，就能在 Windows 10 / 11 上获得一个可装 Play 商店、可获取 root 的安卓子系统。

先判断你要不要用 WSABuilds

它适合三类人：需要在电脑上常驻安卓应用、但官方商店版 WSA 里只有 Amazon Appstore 的人；想给 WSA 刷 Magisk 模块（字体、去广告、LSPosed）的折腾党；以及需要 Google Play 生态但又不想刷机的开发者。如果你只是偶尔装一两个安卓 APK，官方 WSA 或安卓模拟器可能就够了。

注意：微软已于 2025 年 3 月停止对 WSA 的官方支持，项目本身仍持续维护 LTS 版本，但请留意项目主页上的已知问题公告——2025 年 6 月之后带 GApps 的构建在 Windows 11 上曾出现崩溃，官方给出的临时方案是使用 NoGApps 构建或回退 2211/2210 老版本。装之前建议先看一眼 Information.md。

WSABuilds 和官方 WSA 的四个核心差异

应用商店不同。官方 WSA 只能装 Amazon Appstore；WSABuilds 内置 MindTheGapps，Play 商店和 Google 服务开箱即用，绝大多数商店应用可以直接下载。

root 支持。官方 WSA 是只读系统；WSABuilds 通过 Magisk / KernelSU 提供 root，可以装模块修改系统行为，也可以请求 LSPosed 等框架。

预构建而非自编译。官方的 MagiskOnWSA 思路需要你自己跑脚本拼装，WSABuilds 把它做成了按「系统版本 × CPU 架构 × 是否带 Magisk/GApps」分类的成品包，下载即用。

长期维护。对 2311.40000.5.0 及之后的 WSA 版本，项目承诺 LTS 模式：WSA 版本冻结，但 Magisk、KernelSU、GApps 会通过新 Release 持续更新。

安装前自查：系统要求与环境准备

项目	Windows 11	Windows 10
最低构建号	Build 22000.526 及以上	22H2 10.0.19045.2311 及以上（20H1 10.0.19041.264 需手动装 KB5014032 和 KB5022834）
内存	8GB 起步，16GB 推荐	同左
存储	C 盘至少 10GB 空闲，NTFS 分区（不支持 exFAT），强烈建议 SSD	同左
CPU	x86_64 或 arm64，建议达到 Win11 最低 CPU 要求	同左
显卡	Intel HD 530 及更老核显、NVIDIA 显卡可能黑屏或花屏，需切显卡或改用 Microsoft Basic Renderer（参考 ChangingGPU.md）	同左

三个硬性环境条件，缺一个都装不上：

在「可选 Windows 功能」中启用Virtual Machine Platform和Windows Hypervisor Platform（按 Win+R 输入OptionalFeatures.exe回车即可打开）；
BIOS/UEFI 里开启虚拟化，装前可以先在终端跑一下确认：

systeminfo | findstr /I "virtualization"

如果你已装过官方商店版 WSA，必须先完整卸载，再装 WSABuilds。

安装：完整流程与必须避开的坑

去项目 Releases 页下载与你系统、CPU 架构匹配的 .7z 包（别下成 Source code）。
用 7-Zip 解压，并把解压出来的文件夹重命名为 WSA（至少是短名）。长文件夹名是启动失败的高频原因，仓库里明确记录了这个坑。
把文件夹放到一个你会长期保留的位置（如文档目录）。
双击文件夹里的Run.bat，等安装完成；首次启动会弹诊断信息同意框，点掉即可。

注意：如果 Run.bat 的窗口一闪而过、WSA 没装上，用管理员终端手动执行：

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

这行命令就是 Run.bat 背后干的事，手动跑只是绕过权限弹窗。更细的步骤见 Installation.md。

两个常见追问：安装包文件夹能删吗？不能。它注册的是散文件方式的 appx 包，文件夹一删 WSA 就废了。数据会随文件夹走吗？不会，安卓数据在用户目录的 vhdx 里，删文件夹前先备份（见下文）。

首次启动：把 Play 商店和 root 用起来

Play 商店：带 GApps 的构建首次启动后，桌面会出现 Google Play 图标，登录账号即可。装应用前建议在 WSA 设置里把内存调大，并确认设备型号显示正常。

root 与 ADB：打开 WSA 设置 → 开发者选项，启用 ADB 连接（本地回环 localhost:58526）。如果连不上，去设置里看 WSA 实际 IP 再连：

adb connect <ip>:5555

Magisk 模块的线上仓库已被官方下线，装模块要用本地方式：

adb push module.zip /data/local/tmp adb shell su -c magisk --install-module /data/local/tmp/module.zip

系统分区本身是只读的，但 Magisk 模块可以等效修改系统；另外注意 WSA 无法通过 SafetyNet/Play Integrity 的正式校验，对银行类应用要提前有心理预期（兼容明细可查 App Compatibility.md）。

常见错误速查：现象 → 先做什么 → 仍不行怎么办

0x80073CF9 / 0x80073CF0（Run.bat 阶段报这个码）：通常是文件夹名过长、压缩包下载损坏或分区不是 NTFS。先确认安装盘是 NTFS、用 7-Zip 重新解压、把文件夹重命名为 WSA；仍不行就重新下载完整包。详细步骤在 Fix Error 0x80073CF9.md。

0x80073D10：下载到了与 CPU 架构不符的包（比如在 x64 机器上装了 arm64 版）。回 Releases 页按「系统 + 架构」重新选包即可。

0x80073CF6 / 0x80073CFB / 0x80073CFD：多为包不完整或环境残留。先重新下载，再确认 Windows 功能开关和虚拟化都生效，最后用管理员权限重跑安装。

WSA 装完不启动 / 没有闪屏：优先怀疑显卡兼容（Intel HD 530 及以下、NVIDIA 用户高发），按 ChangingGPU 指南切到独显或 Microsoft Basic Renderer 试试。

更新后部分应用打不开、卡在启动画面：清一下对应应用的数据和缓存，或重装该应用；还不行就做数据备份后干净重装。

更多现象（安装脚本失败、图标缺失、键盘失灵等）在 Having Issues.md 里都有对应的修复文档链接。

版本更新与数据备份

更新走「覆盖 + 重注册」路线：关闭 WSA（设置里点 Turn off），把新版 .7z 里的子文件夹内容解压到原 WSA 文件夹上，替换全部文件，再跑一次Run.bat，最后在 WSA 设置的 About 页核对版本号。完整流程见 Updating.md。

数据全在一个文件里：userdata.vhdx，路径为%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\userdata.vhdx。备份就是关掉 WSA 后把这个文件拷走；换构建、干净重装前务必先备份。恢复时先卸载旧 WSA、装好新版，把 vhdx 拷回原目录即可，细节参考 Backup and Restore.md。

该选哪个构建

LTS 构建（版本号带 LTS）：WSA 基线稳定，Magisk 在 GApps 版里默认打包，适合日常主力使用，出问题概率最低。非 LTS 构建：跟进更新的 WSA 版本，但不默认带 Magisk，适合想尝鲜新特性的用户。定制构建：想要指定设备型号（默认 Pixel 5）、特定 root 方案或是否保留 Amazon Appstore 的组合，可以按 Custom Builds.md 里列的字段去项目 Issues 页提请求。

普通用户记住一条：优先下载与你系统匹配的最新 LTS 版，GApps 出现兼容问题就换 NoGApps 版或降级，比追新版更省心。