Windows 上 3 步装好安卓:WSABuilds 带 Play 商店和 Root 的完整安装指南
【免费下载链接】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 是预构建的 WSA 镜像,让你的 Windows 10/11 电脑直接跑安卓 App:内置 Google Play 商店(MindTheGapps),可选 Magisk/KernelSU 获取 root,给想在 Windows 上装安卓环境的新手和普通用户。装完打开 Play 商店就能下载应用,支持 APK 侧载与数据备份。
WSA 官方版和 WSABuilds 怎么选:30 秒判断
微软已于 2025 年 3 月 5 日终止 Windows Subsystem for Android(WSA)的官方支持,商店版从此停止更新。而且官方版不带 Google 服务,装进去的安卓应用很多登录不了,想折腾 root 也没有入口。WSABuilds 由社区接手长期维护(LTS):WSA ≥ 2311 版本会持续出新版,GApps 和 root 方案跟着同步更新。你下载的是打包好的完整镜像,不用再自己拼 Google 框架和 root 方案。
| 对比项 | 官方 WSA(商店版) | WSABuilds |
|---|---|---|
| Google Play 商店 | ❌ 无 GApps,应用登录受限 | ✅ MindTheGapps 预集成 |
| Root 方案 | ❌ 没有入口 | ✅ Magisk / KernelSU / 无 root 可选 |
| 维护状态 | ❌ 2025 年 3 月终止支持 | ✅ LTS 持续出新版 |
| 版本选择 | ❌ 仅最新版 | ✅ 提供 2210/2211 等旧构建 |
WSABuilds 安装前环境自检
动手前先把这 6 项过一遍,任何一项不满足都会在安装中或启动时出问题:
- ✅ 系统版本:Windows 11 Build 22000.526 以上,或 Windows 10 22H2(19041 老版本需先补装 KB5014032、KB5022834)
- ✅ 虚拟化:x86_64 或 arm64 处理器,BIOS/UEFI 中已开启虚拟化
- ✅ 内存与磁盘:内存 8GB 起步(16GB 推荐),系统盘至少 10GB 可用空间
- ✅ 分区格式:安装位置必须是 NTFS 分区,exFAT 不行
- ✅ 功能开关:"虚拟机平台"和"Windows Hypervisor 平台"已启用(Win+R 输入
OptionalFeatures.exe打开) - ✅ 旧 WSA 已清:商店版官方 WSA 彻底卸载,和 WSABuilds 不能共存
先确认一下系统版本:
# 查看 Windows 版本号,Win11 需不低于 22000.526 winver注意:改装系统(ReviOS、Tiny 10/11 等)可能跑不动 WSA。先用原版系统测试,否则分不清是系统魔改的问题还是 WSA 的问题。
WSA 构建包安装主流程:3 步完成
第 1 步:下载对应系统的 WSA 构建包
目标:拿到和你系统匹配的 .7z 文件。
- 去 WSABuilds 项目的 Releases 页
- 按操作系统选 Windows 10 或 11 的下载项,按处理器选 x64 或 arm64;当前主力版本为 2407.40000.4.0 系列
- 别选 "Source code",那不是安装包
验证:得到的是一个 .7z 压缩包,文件名里会标注是否含 GApps / Magisk / NoGApps。
注意:2025 年 6 月后 Windows 11 的 GApps 构建出现过崩溃问题。若装完 Play 商店打不开,改用文件名带
NoGApps的构建。
第 2 步:解压并改名为 WSA 文件夹
目标:得到一个干净、短路径的WSA文件夹。
- 用 7-Zip 解压 .7z 文件
- 把解压出的文件夹重命名为
WSA - 删掉原始 .7z 压缩包
- 把
WSA文件夹移到路径短的位置,文档文件夹即可
验证:文件夹名就是WSA,路径里没有特殊字符。
注意:重命名为
WSA是硬性要求,长文件夹名会导致 WSA 无法启动。这个文件夹之后要一直保留,用着用着删了整套环境就废了(详见下方高频问题)。
第 3 步:运行安装脚本注册 WSA
目标:把 WSA 注册进系统。
- (推荐)进入
WSA文件夹,双击Run.bat,同意管理员权限请求 - (备选)弹窗一闪而过或没有权限时,按 Win+X 打开 Windows 终端(管理员),切到 WSA 文件夹所在位置执行:
# 切换到 WSA 文件夹所在位置 cd "X:\path\to\WSA" # 绕过执行策略限制,手动运行安装脚本 PowerShell.exe -ExecutionPolicy Bypass -File .\Install.ps1验证:安装完成后 WSA 自动启动,终端窗口没有报错。完整安装细节参考 Installation.md。
WSA 首次启动验收清单
- 安装完成后 WSA 自动启动
- 首次启动弹诊断信息同意框,有时出现两个相同窗口,点"确定"即可
- 回 PowerShell 窗口按任意键关闭,再关掉文件资源管理器
- 开始菜单搜 "Windows Subsystem for Android",能搜到并打开
- WSA 设置应用打开正常,不闪退
- Google Play 商店能打开,能看到应用列表
进阶玩法速查:侧载、ADB、备份、GPU
| 玩法 | 适用场景 | 关键操作 | 难度 |
|---|---|---|---|
| APK 侧载 | 装商店没有的 App,支持 APK/XAPK/APKS | 开启开发者模式,配合 WSA-Sideloader | ⭐⭐ |
| ADB 调试 | 命令行安装、用adb logcat抓日志 | 开发者模式开启后adb connect 127.0.0.1:58526 | ⭐⭐⭐ |
| 数据备份还原 | 更新或重装前保住数据 | 复制userdata.vhdx到安全位置,见 Backup and Restore | ⭐⭐ |
| 切换 GPU | 核显过老,或 N 卡花屏、WSA 起不来 | 按 ChangingGPU 指南切换渲染设备 | ⭐⭐ |
高频问题速查
adb 连不上 127.0.0.1:58526
- 现象:
adb connect 127.0.0.1:58526连接失败 - 原因:WSA 的开发者模式没开
- 解法:在 WSA 设置 → Developer 页开启开发者模式;仍不行就看该页显示的 IP,改用
adb connect <IP>:5555
Run.bat 静默失败,WSA 没装上
- 现象:双击
Run.bat后弹窗消失,开始菜单里没有 WSA - 原因:执行策略限制,或 appx(Windows 的现代应用注册包)注册失败
- 解法:先走第 3 步的管理员终端备选流程;还不行就在
WSA目录里执行注册命令拿错误信息:
# 手动注册 appx 包,失败会返回一个 ActivityID(UUID) Add-AppxPackage -ForceApplicationShutdown -ForceUpdateFromAnyVersion -Register .\AppxManifest.xml # 用上一步的 UUID 拉取失败日志,对照排查 Get-AppPackageLog -ActivityID <uuid>装完不敢删 WSA 文件夹
- 现象:想删掉安装目录腾磁盘空间
- 原因:WSA 以"散装文件 + appx 注册"的方式存在,删了文件夹整套环境就废了
- 解法:只要还在用 WSA,这个文件夹就得留着;真要腾空间就先整体卸载再释放
应用卡在闪屏,启动不了
- 现象:原本正常的 App 更新后卡在启动页
- 原因:版本更新后的兼容性问题,GApps 构建在部分 Windows 11 上有已知崩溃
- 解法:先清除该应用的数据和缓存,或重装该应用;无效就做干净安装,动手前务必先备份
userdata.vhdx
更新时删掉旧文件夹重装
- 现象:换新版本时习惯性删旧目录,结果数据没了
- 原因:WSABuilds 支持覆盖式更新,数据会自动保留,删旧目录纯属多余
- 解法:在 WSA 设置里点 "Turn off" 彻底关闭 → 解压新版 .7z 覆盖旧文件夹(全部替换)→ 重跑
Run.bat→ 在设置 About 页核对版本号
更多问题先查 FAQ.md 和 Troubleshooting.md,大部分故障都有现成答案。
WSA 更新与数据安全须知
更新或重装前,先把这个文件复制到安全位置——vhdx:WSA 的全部数据都在这一个虚拟磁盘文件里,你的所有 App 和数据都在其中:
%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\userdata.vhdx更新走覆盖路线,别删旧文件夹重装:WSA 设置里点 "Turn off" 彻底关闭 → 解压新版 .7z 覆盖旧文件夹(全部替换)→ 重跑
Run.bat→ 在设置 About 页核对版本号做干净安装解决兼容性问题之前,必须先备份
userdata.vhdx,数据丢了只能靠这份备份找回动手前扫一眼项目 README 顶部的已知问题公告——GApps 崩溃、构建更新这类时效性信息都发布在那里
【免费下载链接】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
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考