WSABuilds 完整安装指南在 Windows 10/11 快速装好带 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/WSABuildsWSABuilds 提供预构建的 WSAWindows Subsystem for Android安装包把 Google PlayMindTheGapps与 Magisk 或 KernelSU 两种 root 方案直接打进系统让 Windows 10/11 直接运行 Android 应用。官方 WSA 已停止支持这些预构建版本由社区长期维护LTS 构建。全文按判断环境 → 前置准备 → 主线安装 → 首次验证 → 按症状排障 → 更新与数据保全展开跟着做即可从零跑通。1. 判断这台机器能不能跑虚拟化是硬门槛其余是裕量结论WSA 本质是一台虚拟机BIOS 虚拟化没开就直接放弃其他配置只影响体验。系统Windows 11Build 22000.526 及以上或 Windows 10 22H210.0.19045.2311 及以上20H1 需先打 KB5014032 和 KB5022834 补丁虚拟化CPU 支持虚拟化且已在 BIOS/UEFI 中开启Intel 对应 VT-xAMD 对应 AMD-V内存8GB 起步16GB 推荐4~6GB 不建议磁盘目标分区必须是 NTFSC 盘至少留 10GB 可用空间SSD 优先显卡Intel HD Graphics 530 或更老的核显、部分 Nvidia 显卡可能起不来或出现花屏装完后按GPU 切换指南换显卡ReviOS、Tiny 10/11、Ghost Spectre 等魔改系统可能跑不了 WSA遇到装不上的情况不必反复折腾2. 前置准备开启两个系统功能清掉旧版 WSA结论两个 Windows 可选功能没开启是注册失败的头号原因装过官方 WSA 或旧版必须先完整卸载否则会直接冲突。以管理员身份打开 PowerShell依次运行下面两条命令完成后按提示重启Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux Enable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform装过官方 WSA 或旧版 WSABuilds 的先备份数据再完整卸载备份用户数据盘重装后想留数据就靠它%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\userdata.vhdx复制到安全位置开始菜单搜索 Windows Subsystem for Android Settings或在应用和功能里找到卸载删除当初安装用的 WSA 文件夹检查%LOCALAPPDATA%\Packages\下是否还有MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe文件夹有就删掉删不掉先确认 WSA 已关闭完整卸载步骤见 卸载文档。可选需要翻阅仓库内文档时把仓库克隆到本地git clone https://gitcode.com/GitHub_Trending/ws/WSABuilds3. 主线安装下载压缩包重命名成 WSA用 Run.bat 完成注册结论安装就是下载 → 重命名 → 运行脚本三步Run.bat 失败时用管理员终端跑 Install.ps1 兜底。打开仓库发布页按你的系统选最新版构建变体内置组件适合谁MindTheGapps Magisk/KernelSUGoogle 全家桶 root默认选择功能最全无 GApps资产名含 NoGApps Magisk/KernelSU仅 root不需要 Google 服务带 Amazon Appstore 的变体额外含 Amazon 商店需要 Amazon 生态应用无 Root 变体纯净 WSA不折腾 root只下.7z压缩包不要下 Source code。资产名会标注具体变体。解压.7z把解压出来的文件夹重命名为WSA。⚠️ 重命名是硬性要求长文件夹名尤其脚本自动生成的名字会导致 WSA 无法启动务必在装之前改好。删除.7z压缩包把WSA文件夹移到固定位置文档目录即可。⚠️ 这个文件夹之后不能删注册的是未打包的 appx 文件文件夹一删 WSA 就没法运行了。进入WSA文件夹双击Run.bat按提示允许管理员权限。之前装过旧版的话脚本会自动卸载旧版并保留用户数据。弹窗一闪而过、WSA 没装上时改用管理员 PowerShell 手动注册cd X:\path\to\your\WSA PowerShell.exe -ExecutionPolicy Bypass -File .\Install.ps1手动执行仍然失败说明这台机器不支持 WSA不必反复重试。4. 装完首跑核对版本号装上第一个应用结论首次启动会弹诊断信息同意窗口有时出现两个相同窗口都点确认即可验证通过的标准是设置应用能打开且版本号对得上。在开始菜单搜索 Windows Subsystem for Android确认设置应用能正常打开打开关于页签核对版本号与所装构建一致在 PowerShell 窗口按任意键把它关掉装第一个应用两种方式在 Google Play 里直接搜索安装需装带 MindTheGapps 的构建ADB 侧载先打开 WSA 设置开发人员页签的开发人员模式然后执行adb connect 127.0.0.1:58526。侧载工具有 5 种可选见 侧载指南游戏或图形应用异常时在图形和性能页签切换 Android 应用使用的 GPU先关掉 WSA 再改方法见GPU 切换指南5. 高频故障按症状对号入座结论绝大多数安装问题落在下面几类里按症状直接找对应动作通用排障入口见排障总览。症状WSA 起不来 / 无闪屏确认 BIOS 虚拟化已开启确认文件夹名就是WSA路径不含特殊字符确认 WSL 与 VirtualMachinePlatform 两个功能均已启用仍起不来查 WSA 装完无法加载症状Run.bat / Install.ps1 注册失败按错误码对照修复文档0x80073CF0、0x80073CF6、0x80073CF9、0x80073CFB、0x80073CFD、0x80073D10脚本卡在更新环节查 InstallPs1FailedToUpdate通用排查在 WSA 目录执行Add-AppxPackage -ForceApplicationShutdown -ForceUpdateFromAnyVersion -Register .\AppxManifest.xml它应该失败并输出一个 ActivityID再用Get-AppPackageLog -ActivityID ActivityID读取失败日志按日志报错修症状Play 打不开 / Google 服务异常确认装的是带 MindTheGapps 的构建两种 GApps 包之间不能直接切换必须完整卸载后重装详细处理见 Google Play Issues另注2025 年 6 月之后的 Windows 11 上GApps 构建曾出现启动即崩溃的问题仓库 README 有说明受影响时改装资产名含NoGApps的构建或换 2211/2210 老版本症状ADB 连不上 127.0.0.1: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症状应用卡在加载页 / 图标缺失 / 键盘不可用分别查 应用无法工作、图标缺失、键盘不工作需要日志时adb logcat或直接看%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalState\diagnostics\logcat6. 更新与数据保全覆盖更新不丢数据备份只靠一个文件结论更新就是关 WSA → 覆盖文件 → 重跑脚本所有应用和数据都在userdata.vhdx里重装或换机前先备份它。更新详细文档WSA 设置里点 Turn off等加载动画消失确认 WSA-Sideloader 等第三方工具没在运行解压新版.7z打开里面那个WSA_...子目录选中全部文件覆盖到原WSA文件夹提示替换时选对此项及其子项全部适用并选是重新运行Run.bat在关于页签核对版本号备份详细文档把userdata.vhdx路径同第 2 节复制到安全位置就这一个文件恢复完整卸载 WSA → 打开 WSA 文件夹里的Install.ps1删掉里面所有Start-Process wsa://...相关行 → 运行脚本期间弹出的对话框一律不要点 → 把备份的userdata.vhdx放回%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\→ 启动 WSA数据即恢复7. 文档入口常用文档一次给全结论后续遇到问题先翻下面这些仓库内文档基本都能覆盖。排障总览FAQ安装说明更新流程备份与恢复卸载说明应用兼容性侧载指南GPU 切换速查清单确认 Win10 22H2/Win11 22000.526BIOS 虚拟化已开目标分区 NTFS 且留足 10GB确认 WSL 与 VirtualMachinePlatform 两个功能已启用旧版 WSA 已完整卸载数据先备份userdata.vhdx执行下.7z→ 文件夹重命名为WSA→ 双击Run.bat失败则管理员终端跑Install.ps1验证设置应用能打开关于页版本号与构建一致装上一个应用保全更新靠覆盖文件 重跑Run.bat备份与恢复都围绕userdata.vhdx一个文件【免费下载链接】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），仅供参考