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 直接打进系统让 Windows 10/11 的 PC 直接运行带 root 的 Android 应用。先说结论这套镜像适合所有想在 Windows 上跑 Android 应用且需要 root 的人全文按「门槛→清理→安装→验证→排障→维护」六步走翻车高发点一共 4 处目录名没改对、两个系统功能没开、旧版没卸干净、Play 不亮。带着这张地图往下读15 分钟内能装完。️ 准入门槛虚拟化是硬门槛其余都是裕量项先说结论硬件上只有一项是硬门槛——CPU 虚拟化且在 BIOS/UEFI 里打开其余配置都属于裕量问题。硬门槛缺一不能装CPU 支持虚拟化Intel VT-x / AMD-V且已在 BIOS/UEFI 中开启目标分区必须是 NTFSexFAT 分区直接不行Windows 11 build 22000.526 及以上或 Windows 10 22H210.0.19045.2311及以上系统功能 Virtual Machine Platform 已启用开关命令见下一节裕量项不达标也能装体验打折内存8GB 是最低线常开多个应用建议 16GB4~6GB 不推荐磁盘C 盘至少 10GB 空闲SSD 明显优于 HDD架构x86_64 或 arm64 均可但 Win10 下 CPU 最好在 Win11 支持列表里显卡Intel/AMD/Nvidia 都能用但 Intel HD 530 及更早核显、部分 Nvidia 显卡可能起不来或花屏⚠️ BIOS 里没开虚拟化就装注册大概率失败且报含糊错误不先确认它后面所有排障都是白费时间。 冲突清理开三个功能开关卸干净旧版先说结论注册失败的头号原因是系统功能没开二号原因是旧版 WSA 或旧版 MagiskOnWSA 没卸干净——两件事在装之前做完。以管理员身份打开 PowerShell执行Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux Enable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform Enable-WindowsOptionalFeature -Online -FeatureName HypervisorPlatform如果提示需要重启重启后再继续。装过官方 WSA 或旧版 MagiskOnWSA 的先完整卸载开始菜单搜索Windows Subsystem for Android Settings进入卸载卸载完检查%LOCALAPPDATA%\Packages\下是否残留MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe目录有就删掉删不掉说明 WSA 还在运行先关掉。需要查阅完整文档时把仓库克隆到本地git clone https://gitcode.com/GitHub_Trending/ws/WSABuilds⚠️ 要留数据的话卸载前必须先备份 userdata.vhdx完整路径见「长期维护」一节不备份就卸旧数据直接消失。 主线操作拿到 → 就位 → 执行三拍装完先说结论安装本质是「下载 .7z → 重命名文件夹 → 注册 appx」三件事Run.bat 是主方案手动跑 Install.ps1 是兜底。第一拍拿到——从发布页下 .7z资产名就是变体名在发布页的 Assets 区按操作系统Windows 10 / Windows 11和架构x64 / arm64选对应构建下载。各变体差异资产名关键词内置组件适合谁MindTheGapps with-magiskGoogle Play Magisk root默认选择功能最全MindTheGapps KernelSUGoogle Play KernelSU root偏好 KernelSUNoGApps仅 root无 Google 服务不需要 Google 全家桶RemovedAmazon不含 Amazon Appstore不想要 Amazon 商店⚠️ 只下 .7z 安装包别选 Source code (zip)——那是源码里面没有可注册的安装内容选了等于白下。⚠️ GApps 构建在 2025 年 6 月之后的部分 Win11 系统上有崩溃问题你的构建若反复闪退先换 NoGApps 构建或 2211/2210 老构建过渡。此步最容易错在哪选错系统/架构——Win10 机器下了 Windows 11 的包注册必失败。第二拍就位——文件夹必须叫 WSA放固定位置永不许删用 7-Zip 或 WinRAR 解压 .7z。把解压出来的文件夹重命名为WSA就这三个字母。删掉 .7z 压缩包把 WSA 文件夹移到一个固定位置如C:\Users\你的用户名\Documents\WSA之后常驻此机。⚠️ 注册用的是这个文件夹里未打包的 appx 文件AppxManifest.xml文件夹一删 WSA 立刻起不来目录名带长串版本号或特殊字符也会导致无法启动不改名就装等于给自己挖坑。此步最容易错在哪解压后图省事直接装——脚本自动生成的长文件夹名如WSA_2407.40000.4.0_...-RemovedAmazon是启动失败的常见原因。第三拍执行——Run.bat 主方案Install.ps1 兜底进入 WSA 文件夹双击Run.bat按提示允许管理员权限。之前装过旧版 MagiskOnWSA 的话脚本会自动卸载旧版并保留用户数据。若弹窗一闪而过、WSA 没装上用管理员终端WinX → 终端(管理员)手动注册兜底cd {X:\path\to\WSA} # 把 X:\path\to\WSA 换成你实际放 WSA 文件夹的完整路径 PowerShell.exe -ExecutionPolicy Bypass -File .\Install.ps1兜底仍失败时在 WSA 目录执行下面两条用第一条报错里的 ActivityID 查失败日志Add-AppxPackage -ForceApplicationShutdown -ForceUpdateFromAnyVersion -Register .\AppxManifest.xml Get-AppPackageLog -ActivityID ActivityIDActivityID是上一步报错输出中的 UUID。手动执行仍然失败说明这台机器本身不支持 WSA停止反复重试。此步最容易错在哪cd进了错的目录——必须 cd 到直接包含AppxManifest.xml的那层 WSA 文件夹。 跑通验证启动信号、版本号与第一个应用先说结论能打开设置应用、About 页版本号与所装构建一致就算装通了。启动信号首次启动会弹诊断信息同意窗口有时出现两个一模一样的都点 OK 即可随后 PowerShell 窗口显示 Press any key to quit在窗口上按任意键将其关闭。验证点开始菜单搜索Windows Subsystem for Android设置应用能正常打开打开 About 页签版本号应与你下载的构建一致当前 LTS 版本为 v2407.40000.4.0第一个真实任务最小可用示例路线一最省在 Google Play 里搜索任意应用安装并运行路线二ADB 侧载需先在设置里开启开发人员模式adb connect 127.0.0.1:58526游戏/图形应用异常时在设置的「图形和性能」页签切换 Android 应用使用的 GPU先关闭 WSA 再改参考 GPU 切换指南️ 排障矩阵五类高频故障一张表查完先说结论绝大多数装不动的情况都落在下表 5 类里排查顺序固定为「先查硬件与系统功能再查目录与脚本」。症状可能原因处置动作装完起不来、无闪屏BIOS 虚拟化未开WSL/VMP 功能未启用BIOS 开启 VT-x/AMD-V重新启用功能开关后重跑 Run.batRun.bat 注册失败、弹窗一闪而过文件夹名不是 WSA、路径含特殊字符重命名文件夹为 WSA、移到短路径再手动跑 Install.ps1Install.ps1 也失败机器不满足 WSA 硬性要求用Get-AppPackageLog看具体报错后停止重试Google Play 打不开装成了 NoGApps 构建在两种 GApps 变体间直接切换装带 MindTheGapps 的构建切换前必须完整卸载再重装adb 连不上 127.0.0.1:58526开发人员模式未开启设置 → Developer 页签开启仍连不上则读该页显示的 IP改连ip:5555起不来或花屏Intel HD 530 及更早 / Nvidia核显或驱动与 WSA 不兼容在「图形和性能」页签切换 GPU先关 WSA 再改见 ChangingGPU.md表内命令统一放在这里# 查注册失败日志ActivityID 替换为注册报错中的 UUID Add-AppxPackage -ForceApplicationShutdown -ForceUpdateFromAnyVersion -Register .\AppxManifest.xml Get-AppPackageLog -ActivityID ActivityID# ADB 备用连接IP 为 WSA 设置 Developer 页签显示的地址 adb connect WSA-IP:5555 长期维护更新、备份、换机全围绕一个文件先说结论所有应用与数据都存在userdata.vhdx这一个虚拟磁盘里备份、换机、恢复只需要盯住它。路径备份/恢复都指向这里%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\userdata.vhdx更新覆盖安装不丢数据设置里点 Turn off等加载动画消失确认 WSA-System-Control、WSA-Sideloader、WSAPacman 等第三方工具没在运行解压新版 .7z把其子目录内的全部文件覆盖到原 WSA 文件夹替换提示选 Do this for all current items Yes重跑 Run.batAbout 页核对版本号详细步骤见 更新流程备份把 userdata.vhdx 复制到安全位置移动硬盘/网盘均可。恢复/换机按序执行完整卸载 WSA见 卸载说明在 WSA 文件夹的Install.ps1中删掉Start-Process wsa://…相关行行内容随构建变体不同Android Settings 对应Start-Process wsa://com.android.settingsMagisk 对应Start-Process wsa://com.topjohnwu.magisk运行脚本安装期间弹出的对话框一律忽略把备份的 userdata.vhdx 放回%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\目录不存在就先建启动 WSA数据恢复完成。完整流程见 备份与恢复 收尾速查五件事记牢就够查门槛Win11 22000.526 / Win10 22H2BIOS 虚拟化已开WSL VMP HypervisorPlatform 三个功能已启用旧版已卸干净装.7z 解压 → 文件夹改名为WSA→ 双击 Run.bat → 失败则管理员终端手动跑Install.ps1验设置应用能打开About 页版本号与构建一致装第一个应用跑通更Turn off → 覆盖文件 → 重跑 Run.bat → 核对版本保备份与恢复只认userdata.vhdx这一个文件仓库内文档直达安装说明更新流程卸载说明备份与恢复FAQ排障总览ADB 侧载指南Magisk 模块使用【免费下载链接】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），仅供参考