在 Windows 上给安卓装 root:WSABuilds 版本怎么选、数据怎么保、出错怎么排查
【免费下载链接】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
想让 Windows 跑安卓应用还不止于"能跑"?WSABuilds 把 Google Play、Magisk 或 KernelSU 直接打进 WSA 预装包里,Run.bat一条命令完成注册和启动,不用自己刷框架、配 root。本文覆盖从版本选型、常见故障,到数据备份的全部要点。
一分钟判断:WSABuilds 适不适合你这台机器
先看条件,全部满足再往下走:
- 官方 WSA 未安装,或已彻底卸载;系统为 Windows 11(22H2 及以上)或 Windows 10 22H2 及以上
- BIOS/UEFI 已开启虚拟化(VT-x 或 SVM),Windows 功能里的 Virtual Machine Platform 可用
- 内存 8GB 起步,系统盘为 NTFS 且空闲 10GB 以上
- 避开 Intel HD 530 及更早的核显,Nvidia 显卡也可能触发启动失败
改过系统的精简版 Windows(ReviOS、Ghost Spectre 一类)运行 WSA 问题较多,建议标准系统。
装起来:下载、重命名、注册,一次做对
前置检查只用一条命令:
Get-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform, Microsoft-Windows-Subsystem-Linux两项状态都是 Enabled 才继续;不是就先在"可选功能"里勾上再重启。
然后三步装完,每步都有坑:
- 从 WSABuilds 发布页下载匹配系统与架构的 .7z,解压后把目录改名为
WSA,放在短路径(如D:\WSA)。注册依赖这个目录里已有的散文件,之后不能删除或挪走。 - 双击
Run.bat,脚本会自动处理虚拟化检查、注册 Appx 并拉起设置应用;首次启动弹出诊断信息同意框,点掉即可。 - 弹窗一闪而过且 WSA 没装上时,改用管理员终端手动注册:
cd "D:\WSA" PowerShell.exe -ExecutionPolicy Bypass -File .\Install.ps1手动跑完这条脚本,WSA 即完成安装。
注册失败时终端会报一个 ActivityID,立刻用它取日志定位原因:
Get-AppPackageLog -ActivityID <上一步报出的ID>这条命令把注册失败的详细原因打印出来,照着报错处理即可。
验证成功的标志:开始菜单搜到 Windows Subsystem for Android 设置应用并能打开,"关于"页版本号与下载包一致;GApps 版本应能看到 Google Play 图标。
按需配置:选哪个包、GPU 不行换哪个、系统盘满了挪到哪
哪个构建版本?
| 需求 | 选的包 |
|---|---|
| 要 Google Play 生态 | GApps 版(MindTheGapps,内置 Magisk) |
| 不需要 Google,追求稳定 | NoGApps 版 |
| 要 root,想用 KernelSU | KernelSU 版 |
| 纯净环境、不带 root | 无 root 版 |
一个已知状况:2025 年 6 月之后,GApps 版在部分 Windows 11 上存在崩溃问题,官方修复进行中,过渡期选 NoGApps 或 2211/2210 旧版最稳。
WSA 启动失败或花屏,多半是 GPU 的锅
Intel HD 530 及更早核显、部分 Nvidia 独显是重灾区。处理路径:在 WSA 设置里先关机,进入"图形与性能",把"GPU used for apps"切到另一张卡或 Microsoft Basic Renderer。具体操作见 [GPU 切换指南](https://link.gitcode.com/i/1b090644e5e375613e03ef8c94fd7ceb/blob/b624ae38fc006f34bb92ec528a8c795b563ed886/Documentation/Usage Guides/General Usage Guides/ChangingGPU.md?utm_source=gitcode_repo_files)。
系统盘满了,把数据目录挪到别的盘
- WSA 完全停止,把
%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe整个拷到另一块 NTFS 盘,删掉原目录 - 建目录联接指过去:
mklink /J "%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe" "D:\WSAData"这条命令让原路径透明指向新位置,userdata.vhdx 随之落到另一块盘。完整流程见 [MoveToExtDrive.md](https://link.gitcode.com/i/1b090644e5e375613e03ef8c94fd7ceb/blob/b624ae38fc006f34bb92ec528a8c795b563ed886/Documentation/Usage Guides/General Usage Guides/MoveToExtDrive.md?utm_source=gitcode_repo_files)。
怎么更新不掉数据、备份在哪、怎么还原
更新流程:WSA 设置里点"Turn off"并等加载圈消失,确认 WSA-Sideloader、WSAPacman 之类工具没在运行;下载新包,用 7-Zip 把包内子目录的所有文件解压覆盖到现有WSA安装目录,提示替换时全部确认;再跑一次Run.bat,最后在设置"关于"里核对版本号。Magisk 不单独更新,新版 WSA 包自带新 Magisk,走同样流程即可。
数据全在userdata.vhdx(%LOCALAPPDATA%\Packages\...8wekyb3d8bbwe\LocalCache\),应用、账号、设置都在这一个虚拟磁盘里。升级、重装、换机前先拷走它。还原的顺序是:先卸载 WSA,删掉Install.ps1里Start-Process "wsa://..."这类自动拉起应用的行,跑完脚本、WSA 停止状态下把备份的 vhdx 放回 LocalCache 目录,再启动即恢复。详见 Backup and Restore.md。
进阶:侧载、改系统分区和定制构建
日常装应用三选一:WSAFiles 直接把 APK 拖进系统;WSA-Sideloader 适合批量;开 WSA 设置的开发者模式后adb connect 127.0.0.1:58526,是最灵活的路,IP 和端口在设置→开发者页查看。方法细节在 [Sideloading.md](https://link.gitcode.com/i/1b090644e5e375613e03ef8c94fd7ceb/blob/b624ae38fc006f34bb92ec528a8c795b563ed886/Documentation/Usage Guides/Sideloading Guides/Sideloading.md?utm_source=gitcode_repo_files)。
系统分区在 Hyper-V 下只读,无法直接 remount 成读写;想改系统行为走 Magisk 模块,或本地改 system.img 重打。需要特殊组合(指定机型、Magisk 版本、是否保留 Appstore)时,直接在仓库 Issue 区提交定制构建请求。
收尾:三件事就够
先选 NoGApps 版把整条链路跑通,再按需换 GApps;动手大改之前先拷userdata.vhdx;微软已停止官方 WSA 支持,本项目以 LTS 形式维护,更新节奏看发布页。
- [安装排错指南](https://link.gitcode.com/i/1b090644e5e375613e03ef8c94fd7ceb/blob/b624ae38fc006f34bb92ec528a8c795b563ed886/Documentation/Fix Guides/Troubleshooting.md?utm_source=gitcode_repo_files):故障对照入口
- [Magisk 安装说明](https://link.gitcode.com/i/1b090644e5e375613e03ef8c94fd7ceb/blob/b624ae38fc006f34bb92ec528a8c795b563ed886/Documentation/Usage Guides/Post-Installation Guides/Magisk.md?utm_source=gitcode_repo_files)
- WSABuilds 总览与已知问题
【免费下载链接】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),仅供参考