WSABuilds 完整部署指南10 分钟在 Windows 上跑起带 Root 的安卓子系统【免费下载链接】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你需要在 PC 上跑安卓应用或者想要一个带 Root 权限、能装 Google Play 的安卓环境来做测试而官方的 Windows Subsystem for AndroidWSA又功能受限、折腾起来麻烦WSABuilds 就是一站式的预编译部署工具它把 WSA 核心、Google Play 服务MindTheGapps以及 Magisk 或 KernelSU 打包成开箱即用的安装包让你跳过繁琐的手工配置直接得到一个可用的安卓子系统。下面按「先跑起来 → 再查环境 → 分人群配置 → 调优排错」的顺序带你走一遍。先跑起来3 步完成最小安装别急着看配置清单先把环境立起来。整个过程只需要三步拿到安装包。克隆项目仓库从项目的 Releases 页面下载对应你系统的预编译 .7z 包git clone https://gitcode.com/GitHub_Trending/ws/WSABuilds版本选择建议优先 LTS 版版本号形如v2407.40000.4.0_LTS_7稳定性更好想尝鲜新特性再选非 LTS 版如v2407.40000.4.0_v2。解压并放置文件夹。用 7-Zip 解压 .7z 包把解压出来的文件夹重命名为WSA⚠️ 名称里不要带空格和特殊字符然后移到非系统盘根目录例如D:\WSA。路径短能避免路径过长类的启动失败。双击Run.bat。脚本会以管理员权限执行安装遇到 UAC 提示点是。装完后开始菜单里会出现 Windows Subsystem for Android 图标首次启动需要初始化耐心等几分钟。✅ 看到安卓界面亮起你就成功了。接下来才轮到查环境和调配置。安装失败时先对照这张系统前置检查表如果Run.bat弹一下就闪退、或报虚拟化相关错误大概率是下面某项没满足。逐项过一遍检查项要求备注Windows 11 版本Build 22000.526 及以上定制系统ReviOS、Tiny 10/11 等可能不兼容建议原版 WindowsWindows 10 版本22H2 10.0.19045.2311 及以上更老的 20H1 需先装补丁才可能有戏内存最低 8GB推荐 16GB4~6GB 能跑但不推荐存储SSD 优先至少 10GB 可用空间分区必须是NTFS不支持 exFAT处理器x86_64 或 arm64支持虚拟化Win11 机型建议不低于 i3 8 代 / Ryzen 3000 / 骁龙 8c显卡Intel / AMD / Nvidia 均可Intel HD 530 及更早的核显容易图形异常见后文调优部分然后以管理员身份打开 PowerShell确认两个关键功能已开启dism /online /enable-feature /featurename:VirtualMachinePlatform /all dism /online /enable-feature /featurename:HypervisorPlatform /all执行完重启电脑。同时进 BIOS/UEFI 确认虚拟化已开启Intel 平台叫 VT-xAMD 平台叫 SVM。也可以直接按Win R输入OptionalFeatures.exe在图形界面里勾选这两项。版本怎么选LTS 与非 LTS 一张表看懂WSABuilds 同时维护两条发布线文件名和版本号直接决定了你拿到的是什么对比维度LTS 版非 LTS 版当前版本v2407.40000.4.0_LTS_7v2407.40000.4.0_v2更新节奏每月一次每月多次Root 方案带 GApps 的构建默认捆绑 Magisk可选择不捆绑 Magisk 的构建适合谁日常使用、办公、求稳开发测试、追新特性架构x86_64 与 arm64x86_64 与 arm64下载时认准文件名里的关键字带MindTheGapps的是含 Google Play 的构建带NoGApps的没有带AMZ/Removed AMZ的表示是否保留 Amazon Appstore。⚠️ 一个需要知道的现状项目 README 提示2025 年 6 月之后 GApps 构建在 Windows 11 上出现过崩溃问题。如果你中招临时方案是换成文件名含NoGApps的构建或使用更老的 2211 / 2210 版本构建并关注仓库内 issue 的修复进展。自动安装没反应走手动注册这条路Run.bat本质是帮你执行管理员权限下的安装脚本。如果弹窗一闪而过、WSA 没装上手动来按Win X选择Windows Terminal管理员。进入你的 WSA 文件夹并执行安装脚本cd D:\WSA # 替换为你的实际路径 PowerShell.exe -ExecutionPolicy Bypass -File .\Install.ps1如果还是失败可以手动注册包并拿日志定位原因需要管理员权限Add-AppxPackage -ForceApplicationShutdown -ForceUpdateFromAnyVersion -Register .\AppxManifest.xml Get-AppPackageLog -ActivityID uuid第一条命令会失败并返回一个 ActivityIDUUID把它填进第二条命令查详细日志按日志提示修。若手动注册也不行基本可以判定这台机器不支持跑 WSA。按你的身份选配置开发 / 日常 / 企业三档装好只是开始下面三档配置对号入座开发者档选非 LTS 版拿最新 API 支持打开 Windows 设置 系统 开发者选项用 ADB 连上子系统adb connect localhost:58526配好 Android Studio 即可深度调试日常用户档选LTS 版 GApps 构建装好直接进 Google Play在 WSA 设置里开启文件共享方便 PC 与安卓侧传文件有独显的机器确认 WSA 走的是独显渲染图形性能更好企业用户档参照 Documentation/WSABuilds/Custom Builds.md 制作企业定制构建规划多实例与数据隔离把userdata.vhdx纳入定期备份策略路径见下节想继续深究某一档的细节项目文档里有完整的安装与使用指南Documentation/WSABuilds/Installation.md、Documentation/WSABuilds/Usage Guide.md。让 WSA 长期好用调优与数据保护调资源分配。打开 WSA 设置 系统 资源CPU 建议给 4 核及以上内存推荐 8GB虚拟硬盘vhdx建议 64GB。改完重启 WSA 生效。老显卡图形异常就换渲染器。如果你用的是 Intel HD 530 及更早的核显或部分 Nvidia 显卡出现花屏、WSA 起不来按 Documentation/Usage Guides/General Usage Guides/ChangingGPU.md 切换到你机器的独显、第二核显或退回 Microsoft Basic Renderer。更新构建时保留数据。更新流程是在 WSA 设置里点 Turn off 完全关闭子系统 → 用 7-Zip 打开新版 .7z把包内子文件夹里的文件解压合并到你原来的 WSA 目录全部选择替换 → 重跑Run.bat。你的应用和数据会保留最后到设置的 About 页核对版本号即可。步骤细节见 Documentation/WSABuilds/Updating.md。备份关键文件。WSA 的全部用户数据集中在一个文件里%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\userdata.vhdx重装、迁移、大版本更新前把它拷走装完拷回去即可无损恢复。⚠️一条铁律WSA 的 WSA 安装文件夹不能删除、不能移动。因为Add-AppxPackage -Register注册的是未打包文件运行时依赖原始路径下的文件动过位置就只能重新走安装流程。高频故障速查表症状排查动作安装报虚拟化相关错误如 0x80073CF6 一类先确认 BIOS 虚拟化和 Optional Features 两项都开了仍不行就卸载后在启用或关闭 Windows 功能里先关掉Hyper-V、Virtual Machine Platform、Windows Hypervisor Platform、WSL 再重装参考 Documentation/Fix Guides/Post-Install Issues/FixVirtError.md提示路径过长或解压失败WSA 文件夹挪到盘符根目录如D:\WSA目录名不超过 8 个字符别嵌套目录参考 Documentation/Fix Guides/Pre-Install Issues/FixPathTooLong.mdadb connect localhost:58526连不上先确认开发者模式已开启还不行就到 WSA 设置 开发者页看实际 IP改用adb connect ip:5555应用闪退 / 卡在启动画面确认应用架构兼容、WSA 版本满足其最低要求再试 设置 应用 清除数据参考 Documentation/Fix Guides/Post-Install Issues/ 下的对应文档Google Play 连不上网检查 Windows 代理设置必要时在 WSA 设置里重置网络参考 Documentation/Fix Guides/Post-Install Issues/FixInternet.md卸载不干净先关闭 WSA通过添加或删除程序卸载然后删掉 WSA 文件夹最后检查%LOCALAPPDATA%\Packages\下MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe是否残留残留就删流程见 Documentation/WSABuilds/Uninstallation.md从 10 分钟装好第一个 WSA 实例到按身份调档、数据备份、故障速查WSABuilds 能把在 Windows 上稳定跑安卓这件事的门槛压得很低。装好后如果还想深挖 Magisk 模块、KernelSU 提权或自定义构建Documentation/目录下的各篇指南都值得一读遇到仓库没覆盖的问题到项目社区Discord / Issues里问往往有人遇到过同样的坑。【免费下载链接】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 完整部署指南10 分钟在 Windows 上跑起带 Root 的安卓子系统【免费下载链接】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你需要在 PC 上跑安卓应用或者想要一个带 Root 权限、能装 Google Play 的安卓环境来做测试而官方的 Windows Subsystem for AndroidWSA又功能受限、折腾起来麻烦WSABuilds 就是一站式的预编译部署工具它把 WSA 核心、Google Play 服务MindTheGapps以及 Magisk 或 KernelSU 打包成开箱即用的安装包让你跳过繁琐的手工配置直接得到一个可用的安卓子系统。下面按「先跑起来 → 再查环境 → 分人群配置 → 调优排错」的顺序带你走一遍。先跑起来3 步完成最小安装别急着看配置清单先把环境立起来。整个过程只需要三步拿到安装包。克隆项目仓库从项目的 Releases 页面下载对应你系统的预编译 .7z 包git clone https://gitcode.com/GitHub_Trending/ws/WSABuilds版本选择建议优先 LTS 版版本号形如v2407.40000.4.0_LTS_7稳定性更好想尝鲜新特性再选非 LTS 版如v2407.40000.4.0_v2。解压并放置文件夹。用 7-Zip 解压 .7z 包把解压出来的文件夹重命名为WSA⚠️ 名称里不要带空格和特殊字符然后移到非系统盘根目录例如D:\WSA。路径短能避免路径过长类的启动失败。双击Run.bat。脚本会以管理员权限执行安装遇到 UAC 提示点是。装完后开始菜单里会出现 Windows Subsystem for Android 图标首次启动需要初始化耐心等几分钟。✅ 看到安卓界面亮起你就成功了。接下来才轮到查环境和调配置。安装失败时先对照这张系统前置检查表如果Run.bat弹一下就闪退、或报虚拟化相关错误大概率是下面某项没满足。逐项过一遍检查项要求备注Windows 11 版本Build 22000.526 及以上定制系统ReviOS、Tiny 10/11 等可能不兼容建议原版 WindowsWindows 10 版本22H2 10.0.19045.2311 及以上更老的 20H1 需先装补丁才可能有戏内存最低 8GB推荐 16GB4~6GB 能跑但不推荐存储SSD 优先至少 10GB 可用空间分区必须是NTFS不支持 exFAT处理器x86_64 或 arm64支持虚拟化Win11 机型建议不低于 i3 8 代 / Ryzen 3000 / 骁龙 8c显卡Intel / AMD / Nvidia 均可Intel HD 530 及更早的核显容易图形异常见后文调优部分然后以管理员身份打开 PowerShell确认两个关键功能已开启dism /online /enable-feature /featurename:VirtualMachinePlatform /all dism /online /enable-feature /featurename:HypervisorPlatform /all执行完重启电脑。同时进 BIOS/UEFI 确认虚拟化已开启Intel 平台叫 VT-xAMD 平台叫 SVM。也可以直接按Win R输入OptionalFeatures.exe在图形界面里勾选这两项。版本怎么选LTS 与非 LTS 一张表看懂WSABuilds 同时维护两条发布线文件名和版本号直接决定了你拿到的是什么对比维度LTS 版非 LTS 版当前版本v2407.40000.4.0_LTS_7v2407.40000.4.0_v2更新节奏每月一次每月多次Root 方案带 GApps 的构建默认捆绑 Magisk可选择不捆绑 Magisk 的构建适合谁日常使用、办公、求稳开发测试、追新特性架构x86_64 与 arm64x86_64 与 arm64下载时认准文件名里的关键字带MindTheGapps的是含 Google Play 的构建带NoGApps的没有带AMZ/Removed AMZ的表示是否保留 Amazon Appstore。⚠️ 一个需要知道的现状项目 README 提示2025 年 6 月之后 GApps 构建在 Windows 11 上出现过崩溃问题。如果你中招临时方案是换成文件名含NoGApps的构建或使用更老的 2211 / 2210 版本构建并关注仓库内 issue 的修复进展。自动安装没反应走手动注册这条路Run.bat本质是帮你执行管理员权限下的安装脚本。如果弹窗一闪而过、WSA 没装上手动来按Win X选择Windows Terminal管理员。进入你的 WSA 文件夹并执行安装脚本cd D:\WSA # 替换为你的实际路径 PowerShell.exe -ExecutionPolicy Bypass -File .\Install.ps1如果还是失败可以手动注册包并拿日志定位原因需要管理员权限Add-AppxPackage -ForceApplicationShutdown -ForceUpdateFromAnyVersion -Register .\AppxManifest.xml Get-AppPackageLog -ActivityID uuid第一条命令会失败并返回一个 ActivityIDUUID把它填进第二条命令查详细日志按日志提示修。若手动注册也不行基本可以判定这台机器不支持跑 WSA。按你的身份选配置开发 / 日常 / 企业三档装好只是开始下面三档配置对号入座开发者档选非 LTS 版拿最新 API 支持打开 Windows 设置 系统 开发者选项用 ADB 连上子系统adb connect localhost:58526配好 Android Studio 即可深度调试日常用户档选LTS 版 GApps 构建装好直接进 Google Play在 WSA 设置里开启文件共享方便 PC 与安卓侧传文件有独显的机器确认 WSA 走的是独显渲染图形性能更好企业用户档参照 Documentation/WSABuilds/Custom Builds.md 制作企业定制构建规划多实例与数据隔离把userdata.vhdx纳入定期备份策略路径见下节想继续深究某一档的细节项目文档里有完整的安装与使用指南Documentation/WSABuilds/Installation.md、Documentation/WSABuilds/Usage Guide.md。让 WSA 长期好用调优与数据保护调资源分配。打开 WSA 设置 系统 资源CPU 建议给 4 核及以上内存推荐 8GB虚拟硬盘vhdx建议 64GB。改完重启 WSA 生效。老显卡图形异常就换渲染器。如果你用的是 Intel HD 530 及更早的核显或部分 Nvidia 显卡出现花屏、WSA 起不来按 Documentation/Usage Guides/General Usage Guides/ChangingGPU.md 切换到你机器的独显、第二核显或退回 Microsoft Basic Renderer。更新构建时保留数据。更新流程是在 WSA 设置里点 Turn off 完全关闭子系统 → 用 7-Zip 打开新版 .7z把包内子文件夹里的文件解压合并到你原来的 WSA 目录全部选择替换 → 重跑Run.bat。你的应用和数据会保留最后到设置的 About 页核对版本号即可。步骤细节见 Documentation/WSABuilds/Updating.md。备份关键文件。WSA 的全部用户数据集中在一个文件里%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\userdata.vhdx重装、迁移、大版本更新前把它拷走装完拷回去即可无损恢复。⚠️一条铁律WSA 的 WSA 安装文件夹不能删除、不能移动。因为Add-AppxPackage -Register注册的是未打包文件运行时依赖原始路径下的文件动过位置就只能重新走安装流程。高频故障速查表症状排查动作安装报虚拟化相关错误如 0x80073CF6 一类先确认 BIOS 虚拟化和 Optional Features 两项都开了仍不行就卸载后在启用或关闭 Windows 功能里先关掉Hyper-V、Virtual Machine Platform、Windows Hypervisor Platform、WSL 再重装参考 Documentation/Fix Guides/Post-Install Issues/FixVirtError.md提示路径过长或解压失败WSA 文件夹挪到盘符根目录如D:\WSA目录名不超过 8 个字符别嵌套目录参考 Documentation/Fix Guides/Pre-Install Issues/FixPathTooLong.mdadb connect localhost:58526连不上先确认开发者模式已开启还不行就到 WSA 设置 开发者页看实际 IP改用adb connect ip:5555应用闪退 / 卡在启动画面确认应用架构兼容、WSA 版本满足其最低要求再试 设置 应用 清除数据参考 Documentation/Fix Guides/Post-Install Issues/ 下的对应文档Google Play 连不上网检查 Windows 代理设置必要时在 WSA 设置里重置网络参考 Documentation/Fix Guides/Post-Install Issues/FixInternet.md卸载不干净先关闭 WSA通过添加或删除程序卸载然后删掉 WSA 文件夹最后检查%LOCALAPPDATA%\Packages\下MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe是否残留残留就删流程见 Documentation/WSABuilds/Uninstallation.md从 10 分钟装好第一个 WSA 实例到按身份调档、数据备份、故障速查WSABuilds 能把在 Windows 上稳定跑安卓这件事的门槛压得很低。装好后如果还想深挖 Magisk 模块、KernelSU 提权或自定义构建Documentation/目录下的各篇指南都值得一读遇到仓库没覆盖的问题到项目社区Discord / Issues里问往往有人遇到过同样的坑。【免费下载链接】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），仅供参考
