WSABuilds 安装完整指南在 Windows 10/11 上跑起带 Root 的 Android 子系统【免费下载链接】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/WSABuildsWSA 安装一次成功靠的是把前置条件检查清楚、构建包选对。WSABuilds 提供预构建包prebuilt binaries让你在 Windows 10 和 Windows 11 上直接运行 Android 子系统内置 Google Play 商店MindTheGapps与 Magisk 或 KernelSU 两种 root 方案省去自己编译打补丁的麻烦。微软官方 WSA 已于 2025 年 3 月 5 日停止支持而这套开源构建会持续维护本文带你完成一次完整的 WSABuilds 安装从下载、注册包、验证桌面可用到 GPU 切换、APK 侧载和常见报错处理。[!IMPORTANT] 2025 年 6 月之后的构建中包含 GApps 的版本在部分 Windows 11 机器上存在 Google Play 服务崩溃问题见 项目 README 顶部的官方说明。不需要 Play 商店的用户建议直接选文件名带NoGApps的构建可绕开该问题。安装前自检这 5 项过不了就别往下走检查项你的状态最短处理指引CPU 虚拟化VT-x / AMD-V✅ 已开启 / ❌ BIOS 里没开重启进 BIOS/UEFI 打开虚拟化各品牌机型入口不同网上搜你的机型 开启虚拟化即可Windows 功能✅ 已勾选 / ❌ 未勾选按Win R输入OptionalFeatures.exe勾选虚拟机平台和Windows 虚拟机监控程序平台应用后按提示重启官方商店版 WSA✅ 未安装 / ❌ 已安装官方版本必须完全卸载设置 → 应用 → 添加和功能里删除或参考 Uninstallation.md否则无法注册本构建磁盘空间与分区✅ 充足 / ❌ 不足系统盘C 盘至少 10GB 空闲且必须是 NTFS 分区exFAT 不行系统版本✅ 达标 / ❌ 过低Windows 11 需 Build 22000.526 以上Windows 10 需 22H210.0.19045.2311 以上。Win R输入winver查看[!NOTE] 如果你要重装并希望保留旧的应用与数据先备份%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\userdata.vhdx安装完成后再放回原位置。详细流程见 Backup and Restore.md。获取构建包下对版本再动手打开仓库 Releases 发布页找到最新的构建版本如 Windows 11 x64 的Windows_11_2407.40000.4.0_LTS_7_HOTFIX_1。在 Assets 列表下载.7z归档。注意选对 CPU 架构x64 还是 arm64并不要下载 Source code。按构建名挑功能组合MindTheGapps表示内置 Play 商店NoGApps表示没有带Magisk表示内置 Magisk root。如果你只想先查文档不装软件也可以克隆仓库浏览git clone https://gitcode.com/GitHub_Trending/ws/WSABuilds完成安装从 Run.bat 到按任意键退出解压.7z归档把解压出来的文件夹重命名为WSA。删除.7z压缩包把WSA文件夹移动到一个你愿意长期保留的位置文档文件夹是官方推荐的位置。如果之前装过 MagiskOnWSA直接合并进旧文件夹提示替换时选择全部替换旧版会被自动卸载且用户数据保留。进入WSA文件夹找到并双击Run.bat等待 PowerShell 窗口弹出安装过程。窗口如果一闪而过、没请求管理员权限且 WSA 没有装好按Win X打开 Windows 终端管理员输入以下两条命令把{解压路径}换成你的WSA文件夹实际位置含引号cd {解压路径} PowerShell.exe -ExecutionPolicy Bypass -File .\Install.ps1看到 PowerShell 提示 Press any key to quit 时点击该窗口按一下任意键关闭窗口然后关掉文件资源管理器。验证安装是否成功安装完成后 WSA 会自动启动首次安装会先弹出同意诊断信息窗口有时出现两个一模一样的窗口点确定即可不会出任何问题。确认 Android 桌面启动器正常显示没有卡在黑屏或启动画面。打开应用列表看到 Google Play 商店GApps 构建或 Magisk 管理器点开能正常加载。以上都通过安装就算成功如果某一步卡住直接对照下面排障速查。[!NOTE] 这个WSA安装文件夹之后不能删。安装本质是向系统注册一个引用了文件夹内文件的 appx 包删掉它等于拆掉 WSA 本体。进阶玩法装好之后值得做的三件事切换 GPU改善游戏与图形表现能干什么指定 WSA 使用某块显卡渲染绕开个别显卡导致的黑屏、闪退问题Nvidia 显卡、Intel HD 530 及更早的核显容易踩坑。怎么操作打开 WSA 设置 → 图形和性能Graphics and Performance→ 选择用于 Android 应用的 GPU。完整图解见 ChangingGPU.md。适合谁WSA 启动异常、图形错乱或想手动指定独显/核显的用户。侧载 APK装任意 Android 应用能干什么不依赖 Play 商店把 Windows 里的 APK 文件装进 WSA。怎么操作Sideloading.md 列了五种方式Play 商店直接下载、WSA Files 浏览器应用、WSA-Sideloader、WSA Pacman、ADB 命令行挑顺手的用即可。适合谁需要装无商店渠道应用、或者用的是 NoGApps 构建的用户。KernelSU 替代 Magisk以及顺手装个 BusyBox能干什么Magisk 构建上出现模块丢失等不稳定问题时换用稳定性更好的 KernelSU root顺手装 BusyBox 获得完整 Unix 命令行工具集。怎么操作下载 KernelSU Manager 的 apk 后侧载进 WSA见 KernelSU.mdBusyBox 则下载对应 Magisk 模块 zip用 Magisk 管理器安装即可见 BusyBox.md。适合谁对 root 稳定性有要求、或习惯在 Android 上敲命令线的用户。排障速查安装和启动失败先看这 4 条现象原因处理Run.bat双击后窗口闪退没弹管理员授权脚本权限不足或未生效按上节第 5 步手动以管理员身份运行Install.ps1若仍失败说明当前 PC 不被 WSA 支持注册 appx 包失败包注册过程报 ActivityID 错误管理员 PowerShell 进入WSA目录运行Add-AppxPackage -ForceApplicationShutdown -ForceUpdateFromAnyVersion -Register .\AppxManifest.xml记下输出的 ActivityIDUUID再运行Get-AppPackageLog -ActivityID uuid查看失败日志定位原因WSA 黑屏、闪退或图形错乱当前 GPU 不兼容Nvidia 卡与老核显常见按 ChangingGPU.md 换一块显卡或 Microsoft Basic Renderer装完后应用集体闪退 / 卡启动画面2025 年 6 月后 GApps 构建在部分 Win11 机器上的已知问题改用文件名带NoGApps的构建重装或按 README 顶部提示的临时方案处理更多高频问题ADB 连不上、logcat 日志位置、数据备份等可以翻 FAQ.md 和 Troubleshooting.md。装好后日常更新、卸载、备份等后续操作都写在官方文档里入口在 Documentation/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），仅供参考
WSABuilds 安装完整指南在 Windows 10/11 上跑起带 Root 的 Android 子系统【免费下载链接】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/WSABuildsWSA 安装一次成功靠的是把前置条件检查清楚、构建包选对。WSABuilds 提供预构建包prebuilt binaries让你在 Windows 10 和 Windows 11 上直接运行 Android 子系统内置 Google Play 商店MindTheGapps与 Magisk 或 KernelSU 两种 root 方案省去自己编译打补丁的麻烦。微软官方 WSA 已于 2025 年 3 月 5 日停止支持而这套开源构建会持续维护本文带你完成一次完整的 WSABuilds 安装从下载、注册包、验证桌面可用到 GPU 切换、APK 侧载和常见报错处理。[!IMPORTANT] 2025 年 6 月之后的构建中包含 GApps 的版本在部分 Windows 11 机器上存在 Google Play 服务崩溃问题见 项目 README 顶部的官方说明。不需要 Play 商店的用户建议直接选文件名带NoGApps的构建可绕开该问题。安装前自检这 5 项过不了就别往下走检查项你的状态最短处理指引CPU 虚拟化VT-x / AMD-V✅ 已开启 / ❌ BIOS 里没开重启进 BIOS/UEFI 打开虚拟化各品牌机型入口不同网上搜你的机型 开启虚拟化即可Windows 功能✅ 已勾选 / ❌ 未勾选按Win R输入OptionalFeatures.exe勾选虚拟机平台和Windows 虚拟机监控程序平台应用后按提示重启官方商店版 WSA✅ 未安装 / ❌ 已安装官方版本必须完全卸载设置 → 应用 → 添加和功能里删除或参考 Uninstallation.md否则无法注册本构建磁盘空间与分区✅ 充足 / ❌ 不足系统盘C 盘至少 10GB 空闲且必须是 NTFS 分区exFAT 不行系统版本✅ 达标 / ❌ 过低Windows 11 需 Build 22000.526 以上Windows 10 需 22H210.0.19045.2311 以上。Win R输入winver查看[!NOTE] 如果你要重装并希望保留旧的应用与数据先备份%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\userdata.vhdx安装完成后再放回原位置。详细流程见 Backup and Restore.md。获取构建包下对版本再动手打开仓库 Releases 发布页找到最新的构建版本如 Windows 11 x64 的Windows_11_2407.40000.4.0_LTS_7_HOTFIX_1。在 Assets 列表下载.7z归档。注意选对 CPU 架构x64 还是 arm64并不要下载 Source code。按构建名挑功能组合MindTheGapps表示内置 Play 商店NoGApps表示没有带Magisk表示内置 Magisk root。如果你只想先查文档不装软件也可以克隆仓库浏览git clone https://gitcode.com/GitHub_Trending/ws/WSABuilds完成安装从 Run.bat 到按任意键退出解压.7z归档把解压出来的文件夹重命名为WSA。删除.7z压缩包把WSA文件夹移动到一个你愿意长期保留的位置文档文件夹是官方推荐的位置。如果之前装过 MagiskOnWSA直接合并进旧文件夹提示替换时选择全部替换旧版会被自动卸载且用户数据保留。进入WSA文件夹找到并双击Run.bat等待 PowerShell 窗口弹出安装过程。窗口如果一闪而过、没请求管理员权限且 WSA 没有装好按Win X打开 Windows 终端管理员输入以下两条命令把{解压路径}换成你的WSA文件夹实际位置含引号cd {解压路径} PowerShell.exe -ExecutionPolicy Bypass -File .\Install.ps1看到 PowerShell 提示 Press any key to quit 时点击该窗口按一下任意键关闭窗口然后关掉文件资源管理器。验证安装是否成功安装完成后 WSA 会自动启动首次安装会先弹出同意诊断信息窗口有时出现两个一模一样的窗口点确定即可不会出任何问题。确认 Android 桌面启动器正常显示没有卡在黑屏或启动画面。打开应用列表看到 Google Play 商店GApps 构建或 Magisk 管理器点开能正常加载。以上都通过安装就算成功如果某一步卡住直接对照下面排障速查。[!NOTE] 这个WSA安装文件夹之后不能删。安装本质是向系统注册一个引用了文件夹内文件的 appx 包删掉它等于拆掉 WSA 本体。进阶玩法装好之后值得做的三件事切换 GPU改善游戏与图形表现能干什么指定 WSA 使用某块显卡渲染绕开个别显卡导致的黑屏、闪退问题Nvidia 显卡、Intel HD 530 及更早的核显容易踩坑。怎么操作打开 WSA 设置 → 图形和性能Graphics and Performance→ 选择用于 Android 应用的 GPU。完整图解见 ChangingGPU.md。适合谁WSA 启动异常、图形错乱或想手动指定独显/核显的用户。侧载 APK装任意 Android 应用能干什么不依赖 Play 商店把 Windows 里的 APK 文件装进 WSA。怎么操作Sideloading.md 列了五种方式Play 商店直接下载、WSA Files 浏览器应用、WSA-Sideloader、WSA Pacman、ADB 命令行挑顺手的用即可。适合谁需要装无商店渠道应用、或者用的是 NoGApps 构建的用户。KernelSU 替代 Magisk以及顺手装个 BusyBox能干什么Magisk 构建上出现模块丢失等不稳定问题时换用稳定性更好的 KernelSU root顺手装 BusyBox 获得完整 Unix 命令行工具集。怎么操作下载 KernelSU Manager 的 apk 后侧载进 WSA见 KernelSU.mdBusyBox 则下载对应 Magisk 模块 zip用 Magisk 管理器安装即可见 BusyBox.md。适合谁对 root 稳定性有要求、或习惯在 Android 上敲命令线的用户。排障速查安装和启动失败先看这 4 条现象原因处理Run.bat双击后窗口闪退没弹管理员授权脚本权限不足或未生效按上节第 5 步手动以管理员身份运行Install.ps1若仍失败说明当前 PC 不被 WSA 支持注册 appx 包失败包注册过程报 ActivityID 错误管理员 PowerShell 进入WSA目录运行Add-AppxPackage -ForceApplicationShutdown -ForceUpdateFromAnyVersion -Register .\AppxManifest.xml记下输出的 ActivityIDUUID再运行Get-AppPackageLog -ActivityID uuid查看失败日志定位原因WSA 黑屏、闪退或图形错乱当前 GPU 不兼容Nvidia 卡与老核显常见按 ChangingGPU.md 换一块显卡或 Microsoft Basic Renderer装完后应用集体闪退 / 卡启动画面2025 年 6 月后 GApps 构建在部分 Win11 机器上的已知问题改用文件名带NoGApps的构建重装或按 README 顶部提示的临时方案处理更多高频问题ADB 连不上、logcat 日志位置、数据备份等可以翻 FAQ.md 和 Troubleshooting.md。装好后日常更新、卸载、备份等后续操作都写在官方文档里入口在 Documentation/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），仅供参考
