15分钟装好WSABuilds：Windows上带Google Play和Magisk运行Android的完整指南-平芜编程栈

15分钟装好WSABuilds：Windows上带Google Play和Magisk运行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

WSABuilds 是一个开源项目，它把微软已经停更的 Windows Subsystem for Android（WSA，可以理解为"Windows 内置的安卓虚拟机"）做成了开箱即用的预构建包：Google Play 商店（通过 MindTheGapps 实现）、Magisk 或 KernelSU 这些 root 方案都已经打包进 .7z 压缩包里，你只需要解压、注册、启动。这篇文章按"选包 → 自检 → 安装 → 排错 → 进阶"的顺序走一遍，目标是用最少的时间让一台 Windows 10 或 11 的电脑跑起安卓应用，卡住时知道去哪一步查。

微软已于 2025 年 3 月 5 日起停止对 WSA 的官方支持。WSABuilds 对 WSA 版本 ≥ 2311.40000.5.0 的构建进入了 LTS（长期支持）阶段，当前最新的是 LTS 7 Hotfix（v2407.40000.4.0），Magisk、KernelSU 和 GApps 会随新发布持续更新，所以这条路线目前仍然可用。

先花2分钟看懂该下载哪个包

Releases 页面里的 .7z 文件名就是整台"虚拟安卓机"的配置单。看不懂命名，装错了比不装更麻烦，所以先把文件名拆开：

命名片段	含义	怎么选
Windows 11 / Windows 10	目标系统	和系统版本对应，不要交叉
x64 / arm64	CPU 架构	绝大多数 PC 是 x64，ARM 芯片的 Windows 才选 arm64
版本号（如 2407.40000.4.0）	WSA 基础版本	日常使用选 LTS 7 Hotfix 即可
with-magisk / KernelSU / 无 root 字样	内置的 root 方案	不需要 root 就选无 root 的包
MindTheGapps / NoGApps	是否含 Google Play 商店及框架	要装安卓应用选含 GApps；遇到兼容问题再换 NoGApps
RemovedAmazon / 带 Amazon Appstore	是否保留亚马逊应用商店	想要纯净环境选 RemovedAmazon

两个容易踩的坑先说清楚。

先确认你的系统是正版 Windows 10/11，再执行后续安装步骤。ReviOS、Tiny 10/11 这类精简魔改系统删掉了 WSA 依赖的组件，注册环节大概率失败。

先确认 Windows 11 上是否近期出现 GApps 版闪退（2025 年 6 月后的已知问题），再决定版本。若中招，优先换用文件名带 NoGApps 的构建，或者退回 2210/2211 的旧版 WSA。

安装前10分钟自检

WSA 的本质是一台 Hyper-V 虚拟机，虚拟机跑不起来的问题，绝大多数在装之前就能排除。按顺序做一遍：

查系统版本。设置 → 系统 → 关于，确认 Windows 11 构建号 ≥ 22000.526，或 Windows 10 ≥ 22H2 的 10.0.19045.2311。20H1（10.0.19041.264）也能用，但要先手动装 KB5014032 和 KB5022834 两个补丁。
查内存与磁盘。内存 8GB 起步、16GB 更稳；系统盘（C:）至少留 10GB 空闲，装 SSD 的应用加载速度会明显更好。
查分区格式。安装文件夹必须放在 NTFS 分区上，exFAT 和 FAT32 都不行。右键盘符看"文件系统"一栏即可。
开两个 Windows 功能（管理员 PowerShell）：

# 启用虚拟机平台（WSA 运行所必需的 Hypervisor 组件） dism /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart # 启用 Windows Hypervisor 平台 dism /online /enable-feature /featurename:HypervisorPlatform /all /norestart

也可以按Win + R输入OptionalFeatures.exe，在图形界面里勾选这两项。改完重启。

开 BIOS 虚拟化。用任务管理器"性能"页确认没有"虚拟化：已禁用"的字样；如果是禁用状态，进 BIOS/UEFI 打开 Intel VT-x 或 AMD-V。
查显卡。Intel HD Graphics 530 及更早的核显、以及部分 NVIDIA 显卡存在启动失败或花屏的已知问题。这类机型参考切换显卡指南，把 WSA 切到另一块核显/独显或"Microsoft 基本显示适配器"上跑。

自检全过，就可以进安装主线了。

主线：从 .7z 到安卓设置界面，6步走完

从 Releases 页面下载对应系统和架构的 .7z（不要下 Source code），用 7-Zip 解压。
把解压出来的文件夹重命名为WSA，然后移到一个你确定不会再动的位置（文档目录是个好选择）。这个文件夹不能删——WSA 是通过Add-AppxPackage -Register以"已解包文件"方式注册的，文件一删，注册就失效。
双击文件夹里的Run.bat。如果之前装过官方 WSA 或旧版 WSABuilds，脚本会先卸载旧版再装新版，用户数据会保留。
如果弹窗一闪而过、WSA 没装上，说明脚本没拿到管理员权限。手动补一次：

# 管理员 PowerShell 中进入你的 WSA 文件夹 cd "C:\Users\<你的用户名>\Documents\WSA" # 以绕过执行策略的方式手动跑安装脚本 PowerShell.exe -ExecutionPolicy Bypass -File .\Install.ps1

安装完成后 WSA 会自动启动。首次安装会弹诊断信息同意框，有时出现两个一模一样的窗口都点掉即可，属正常现象。PowerShell 窗口出现后按任意键关闭，文件资源管理器也可以关了。
在开始菜单搜 "Windows Subsystem for Android"，能打开设置界面就算装成了。想验证 Play 商店是否可用，直接在 WSA 里打开 Google Play 装一个测试应用。

到这里主线结束。接下来两条支线互相独立：装不上的看排错卡，装上了的看进阶玩法。

排错支线：四种最常见的安装失败

排错的通用思路只有一条：先拿到详细日志，再按日志里的错误码对号入座。在 WSA 文件夹里执行：

# 重新注册包，预期失败，报错信息里会有一个 ActivityID（UUID） Add-AppxPackage -ForceApplicationShutdown -ForceUpdateFromAnyVersion -Register .\AppxManifest.xml # 用 UUID 拉取这次失败操作的详细日志 Get-AppPackageLog -ActivityID <上一步拿到的UUID>

下面是四张症状卡。

症状一：0x80073D10，双击 Run.bat 直接报错

这是架构装反了——在 x64 系统上装了 arm64 包，或反过来。处理：用任务管理器确认系统类型，回 Releases 换正确架构的包重下即可。详见 Fix Error 0x80073D10。

症状二：0x80073CF6，"Package could not be registered"

这个错误是个筐，装不上的各种原因最后都可能落成它。按这个顺序处理：

确认安装盘是 NTFS；
重新下载 .7z（下载或解压中断会造成文件损坏）；
卸载旧 WSA，并清掉这三个目录里所有名字含WindowsSubsystemForAndroid的残留文件夹：C:\ProgramData\Microsoft\Windows\AppRepository、C:\ProgramData\Microsoft\Windows\WindowsApps、%LOCALAPPDATA%\Packages；
重启，再装一次。

还不行就看上面拉出来的日志，里面会藏着真正的错误码：

日志中的错误码	原因	处理
0x800706D9	Windows 防火墙服务异常	确认 Windows 防火墙为开启状态、服务在运行，第三方防火墙放行新规则，重启
0x80073B06	包内启动画面/清单文件无法识别	预构建包就重新下载；自制包则删掉旧仓库重新 clone 再构建
0x80070002	路径问题	换不含特殊字符的英文短路径，避开超过 260 字符的深层目录

更完整的对照见 0x80073CF6 排错文档和总排错索引。

症状三：装上了，但打不开或开一下就闪退

先确认 BIOS 虚拟化和上面"Windows 功能"两项都真的开好了（改完必须重启才生效），再看 WSA 设置里的显卡项，按 GPU 切换指南换一块卡试试。

症状四：adb 连不上

WSA 设置 → 开发者，先打开"开发者模式"，再执行adb connect 127.0.0.1:58526。连不上就看设置 → 开发者页面里显示的 WSA 实际 IP，换成那个地址再连。

排错卡走完仍失败的话，把Get-AppPackageLog的输出连同 WSA 版本号一起发到项目 Issues，这是最高效的求助方式。装成功的人可以跳去支线 B。

进阶支线：跑起来之后的三件事

接入 adb。开发者模式开启后，adb 是管理 WSA 的主要入口，应用日志、root 模块安装都靠它：

# 连接 WSA（端口 58526） adb connect 127.0.0.1:58526 # 查看安卓系统日志 adb logcat

不想开 adb 也行，日志文件直接在 Windows 侧：%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalState\diagnostics\logcat。

装 Magisk 模块。内置的 Magisk 在线模块列表是空的（上游主动下线了仓库），本地安装走这两条：

# 把模块推送到 WSA 的临时目录 adb push module.zip /data/local/tmp # 用 root 权限安装 adb shell su -c magisk --install-module /data/local/tmp/module.zip

注意 WSA 的 system 分区由 Hyper-V 以只读方式挂载，不能直接改；要动系统层的东西，正规做法就是 Magisk 模块。

处理 Play Integrity 的预期。虚拟安卓机没有 Google 的签名背书，SafetyNet / Play Integrity 这类检测默认过不了，个别对检测敏感的应用会拒载。这不是安装错误，属于 WSA 的固有边界，遇到时查一下应用兼容列表确认该应用的已知状态。

需要更具体的构建（指定机型、指定 Magisk 版本或 GApps 版本、去不去 Amazon 商店），可以去项目 Issues 提定制构建请求，说明设备型号、root 方案、GApps 取舍即可；也参考仓库里的自定义构建说明。

日常用的话，这些进阶项做完就可以停手了。下面这条只在你准备升级 WSA 版本时才需要看。

更新与数据迁移：一个 vhdx 文件的事

WSA 里所有应用和数据都装在一个虚拟硬盘文件userdata.vhdx里，路径是：

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

升级 WSA 版本（数据保留）：

在 WSA 设置里点"Turn off"，等加载圈消失，确认 WSA 和 WSA-System-Control、WSAPacman 这类第三方工具都不在运行；
下载新版 .7z，把里面子文件夹（如WSA_2407.40000.4.0_...）中的文件解压到你现有的 WSA 文件夹里覆盖，替换提示统一选"替换目标中的文件"；
重跑Run.bat；
打开 WSA 设置 → About，核对版本号是否已变更。

流程细节见 Updating 文档。

整机迁移或重装前：先备份userdata.vhdx到安全位置，完整步骤（包括恢复前需要临时去掉 Install.ps1 里几行Start-Process "wsa://..."的做法）在 Backup and Restore 文档里有逐步说明。卸载、彻底清理则参考 Uninstallation 文档。

收尾：几条例外的边界

最后留四条容易问到的边界结论，方便下次直接查：

WSA 文件夹永远不要删，注册机制依赖这些文件；
GApps 方案之间（OpenGApps ↔ MindTheGapps）不能互切，必须彻底卸载后重装；
卸载 WSA 后想还原旧数据，先按备份文档恢复userdata.vhdx再启动；
构建脚本和安装脚本都在仓库里：构建侧看 MagiskOnWSA/scripts/，安装侧看 MagiskOnWSA/installer/，遇到本文没覆盖的报错，先翻 Fix Guides 目录和 FAQ，再提 Issue。

装好的那台"安卓机"和普通 WSA 的唯一区别，是它自带 Play 商店和 root——剩下的玩法，和任何一台装了 Magisk 的安卓设备没有分别。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考