WSABuilds 使用教程：在 Windows 上装好带 Google Play 和 Magisk 的安卓子系统

WSABuilds 使用教程在 Windows 上装好带 Google Play 和 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微软已经为 Windows Subsystem for Android下称 WSA的官方支持画上了句号2025 年 3 月 5 日起 Amazon Appstore 及依赖 WSA 的应用不再受支持。WSABuilds 这个开源项目提供的是一系列预构建的 WSA 安装包内置 Google Play 商店所需的 GApps 组件MindTheGapps以及 Magisk 或 KernelSU 两套 root 方案支持 Windows 10 和 Windows 11。适合想在 PC 上继续运行安卓 App、并且希望有 Google 服务或 root 权限的普通用户。它适合你吗先确认一下你的使用场景你想在 Windows 电脑上直接装安卓 App并且需要 Google Play 商店你想在 WSA 里获得 rootMagisk / KernelSU跑一些依赖 root 的模块或工具你的电脑是 x86_64 或 arm64 架构并且愿意花十分钟做一次系统配置。如果你只是想体验原版 WSA、不需要 rootMicrosoft Store 里的官方版本如果还能找到可能更省事WSABuilds 的卖点在于Google 服务 root这一组合。前置条件对照表项目要求系统版本Windows 11Build 22000.526 及以上Windows 1022H210.0.19045.2311及以上。更老的 10 20H110.0.19041.264需要额外安装 KB5014032 和 KB5022834 两个补丁才可能运行内存最低 8 GB建议 16 GB4~6 GB 不建议磁盘系统盘C 盘至少 10 GB 可用空间分区必须是 NTFS不支持 exFATSSD 体验明显好于机械盘处理器x86_64 或 arm64 架构Windows 11 机器建议满足 i3 八代 / Ryzen 3000 级别以上虚拟化CPU 支持虚拟化且在 BIOS/UEFI 和 Windows 可选功能中均已启用另外两点提醒经过裁剪修改的 Windows 系统各种精简版运行 WSA 容易出问题建议用标准系统Nvidia 显卡和 Intel HD 530 及更早的核显已知容易出现启动失败或画面异常遇到时参考仓库里的 GPU 切换指南 把渲染器切到其他显卡或 Microsoft Basic Renderer。装之前先做这几件事按重要性排序每一步说明为什么确认旧版 WSA 已彻底卸载。官方 WSA 和 WSABuilds 不能共存必须先完整卸载官方版本否则注册包会冲突。启用两个 Windows 可选功能虚拟机平台Virtual Machine Platform和 Windows Hypervisor 平台。这是 WSA 运行的基础组件缺一个都装不上。操作按Win R输入OptionalFeatures.exe回车勾上这两项后点确定。确认 BIOS/UEFI 里的虚拟化已开启。上面第 2 步只是系统层CPU 层的虚拟化开关在主板设置里不同厂商位置不同找不到开关名称时搜VT-xIntel或SVMAMD。清理磁盘并想好安装包放哪。C 盘预留 10 GB解压出来的 WSA 文件夹要长期保留安装脚本只是把文件夹里的文件注册为 appx 包删了文件夹 WSA 就不能用了所以别放临时目录文档目录这类稳定位置比较合适。如果已有旧数据想保留先备份。把%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\userdata.vhdx这个文件拷走它就是全部 App、数据与设置的载体。跟做一遍就能跑通第一步下载对应的安装包去项目的 Releases 发布页按自己的系统选版本Windows 11 分 x64 和 arm64 两种Windows 10 只有 x64每个系统又有稳定版和预发布版按钮追求稳就用稳定版文件名里带有NoGApps的包不含 Google 服务需要 Play 商店就选带 GApps 的包只下载.7z安装包不要下Source code。第二步解压、改名、摆放用 7-Zip 或 WinRAR 解压.7z把解压出来的文件夹重命名为WSA这一步脚本会用到别跳过把文件夹移到你想长期保留的位置如文档目录原始的.7z可以删掉。容易卡住的点路径里避免中文和空格如果是升级而非首次安装直接把新文件覆盖进旧文件夹即可数据会保留。第三步运行 Run.bat打开 WSA 文件夹双击Run.bat。脚本会请求管理员权限点是。如果之前装过 MagiskOnWSA脚本会自动卸载旧版保留数据再装新版。容易卡住的点如果弹窗一闪而过、WSA 没装成功说明脚本没有拿到管理员权限。手动处理按Win X打开 Windows 终端管理员依次执行把路径换成你的 WSA 文件夹cd X:\path\to\WSA PowerShell.exe -ExecutionPolicy Bypass -File .\Install.ps1如果这样仍然失败大概率是硬件或系统环境不支持可以先看仓库的 安装指南 里的诊断命令排查注册失败的具体原因。第四步完成首次启动安装完成后 WSA 会自动启动。首次使用会出现一个同意诊断信息收集的窗口点确定即可偶尔会弹出两个相同窗口都点确定没有副作用。之后按提示在 PowerShell 窗口按任意键关闭就可以在开始菜单里找到 Windows Subsystem for Android 了。装好之后能玩什么WSABuilds 的包由几个可选组件拼成常见的组合关系如下组件提供的能力适合谁MindTheGappsGAppsGoogle Play 商店、Play 服务和账号体系需要装 Google Play 里 App 的用户这也是最主流的用法NoGApps只保留原生 WSA 亚马逊应用商店不想引入 Google 服务、只要纯净安卓环境的人Magisk传统 root 方案支持 Magisk 模块想用大量成熟 root 模块的人KernelSU基于内核的 root 方案部分场景下更隐蔽稳定对 root 隐藏有要求、或 Magisk 表现不佳的人Amazon Appstore保留/移除亚马逊应用商店部分包名会标注 Removed Amazon按个人习惯取舍组合是自由搭配的四选一叉乘例如MindTheGapps Magisk是目前覆盖人群最多的方案NoGApps KernelSU则是最干净的 root 组合。想要特定搭配比如特定 Magisk 版本、特定设备模型时可以在项目的 Issues 里提交自定义构建请求详见 Custom Builds 说明。踩坑速查WSA 打不开 / 黑屏闪退→ 优先怀疑虚拟化没开全BIOS 开关、虚拟机平台、Hypervisor 平台三处都要确认。都确认了还不行再按 故障排查文档 的路子走先用官方 WSA 测试环境本身是否有问题不行就提交 Feedback Hub 报告。装了 GApps 的包在 Windows 11 上启动后崩溃2025 年 6 月后出现的已知问题→ 项目 README 顶部有说明两条可行路径换用文件名带NoGApps的包或按 Issues 区给出的临时修复操作另外 2211/2210 老版本被证实仍可用。应用卡在闪屏、装不上或加载异常→ 常见于大版本更新后。先在 WSA 设置里清除该应用的数据和缓存不行就卸载重装该应用个别顽固情况需要整机干净重装记得先备份 userdata.vhdx。应用连不上网 / 打不开网页→ 检查 Windows 防火墙是否拦截了 WSA尝试网络重置必要时改用公共 DNS如 8.8.8.8并确认系统代理设置没有指向错误的地址。仓库有专门的 网络修复指南。画面花屏、渲染异常或 Nvidia/老核显直接起不来→ 这是显卡兼容性问题不是安装问题。按 GPU 切换指南 把 WSA 的渲染器切换到集显、独显或 Microsoft Basic Renderer。Magisk 在线模块列表是空的→ Magisk 官方已下线在线模块库改成本地安装adb push module.zip /data/local/tmp然后adb shell su -c magisk --install-module /data/local/tmp/module.zip。想换 GApps 来源比如从 MindTheGapps 换 OpenGApps→ 不能直接覆盖GApps 会失效必须先完整卸载再重装。给进阶用户的几招备份与恢复数据备份只需复制userdata.vhdx路径见上文到安全位置。恢复流程先完整卸载现有 WSA打开 WSA 文件夹里的Install.ps1删掉末尾自动拉起 App 的那几行Start-Process wsa://...具体是哪几行取决于你的包带了哪些组件对照 备份恢复文档 里的清单运行安装脚本当 PowerShell 窗口显示Press any key to quit时会出现若干弹窗不要点任何东西先去%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\目录不存在就手动建把备份的userdata.vhdx放回去关掉弹窗正常启动 WSA数据应当恢复。ADB 调试在 WSA 设置里打开开发者选项后即可从 Windows 侧用 ADB 连接。通常执行adb connect localhost:58526如果连不上到 WSA 设置的 Developer 页查看实际分配的 IP改连ip:5555。连上后adb logcat可以看系统日志装 APK、推文件也都是标准 ADB 用法。存储与空间管理WSA 的体积随安装的应用增长userdata.vhdx会不断变大。三个实用动作在 WSA 设置里定期查看存储占用卸载不用的安卓应用并清理缓存C 盘紧张时可以把整个 WSA 迁移到其他分区要求目标分区为 NTFS仓库里有专门的 迁移指南。升级版本升级不丢数据关闭 WSA 后把新版.7z里的子文件夹内容整体覆盖进旧 WSA 文件夹提示替换时全部选择对当前所有项执行并替换文件再跑一次Run.bat。之后在 WSA 设置的 About 页核对版本号。Magisk 的升级同理等带新版 Magisk 的发布包出来再覆盖安装即可。下一步去哪如果需要源码或完整仓库可用git clone https://gitcode.com/GitHub_Trending/ws/WSABuilds拉取。日常使用中最常用的几个入口安装指南、FAQ、故障排查文档以及各分支的具体操作文档Documentation/Usage Guides/。遇到上面没覆盖的问题优先去项目 Issues 或官方 Discord 社区提问那里反馈最快。【免费下载链接】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），仅供参考