Windows 安卓子系统 WSA 从 0 到可用的完整指南WSABuilds 安装、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/WSABuildsWSABuilds 提供 Windows 10/11 的安卓子系统预构建包内置 Google Play 商店与 Magisk/KernelSU root 方案适合开发测试、应用侧载与手游大屏操作。 快速上手WSA 从下载到启动的完整动作确认系统达标。Windows 11 需 22000.526 以上版本Windows 10 建议 22H2 以上内存 8GB 起步16GB 更稳系统盘至少留 10GB 空闲空间且必须是 NTFS 分区。开启虚拟化。任务管理器 → 性能 → CPU确认虚拟化已启用未启用就进 BIOS/UEFI 打开。再按WinR输入OptionalFeatures.exe勾选 Virtual Machine Platform 与 Windows Hypervisor Platform。下载对应版本的 .7z 压缩包。项目 Releases 页面按操作系统Windows 10 / 11和架构x64 / arm64分列选与本机匹配的那一个不要下载 Source code。版本选择是这里的唯一决策点文件名含MindTheGapps的包自带 Google Play 商店与 Google Play 服务开箱即可装商店应用含NoGApps的包不带更干净适合打算用 Aurora Store 等渠道装应用的用户。两者都可用 Magisk 获取 root。解压并把文件夹改名为WSA放到路径尽量短的位置如C:\WSA。不要保留带日期、带版本号的长文件夹名过长的安装路径是 WSA 起不来的常见原因。双击文件夹里的Run.bat开始安装。脚本会自动注册 WSA 包并拉起窗口首次安装会先弹诊断信息授权对话框点同意即可。如果弹窗一闪而过、WSA 没装上改用管理员方式手动跑在管理员 PowerShell 中cd到解压目录执行PowerShell.exe -ExecutionPolicy Bypass -File .\Install.ps1。详细步骤见 安装文档。⚙️ 它是怎么跑起来的WSABuilds 技术链路速览微软的官方 WSA 本是以商店应用形式分发的WSABuilds 基于 MagiskOnWSA 的思路把 WSA 拆包成一组本地文件用Add-AppxPackage -Register AppxManifest.xml在本地直接注册运行。这样就不再依赖 Microsoft Store老版本2210 到 2407可以继续用Windows 10 也能装旧版本构建 都能找到。包内还预置了两条隐形链路libhoudini兼容层负责在 x86_64 系统上翻译运行 ARM/ARM64 应用cacerts目录提供系统证书信任链保证商店下载和应用联网正常。代价是一条硬性规则这个本地文件夹必须一直保留。WSA 是以已解包应用方式注册的删掉文件夹等于删掉系统本身升级新版本时也是把文件覆盖进同一个目录。️ 装完必做的配置WSA 安装后必做设置按使用频率从高到低前三项几乎每个用户都会用到等首次启动走完。WSA 第一次启动会初始化内部系统耗时较长中途不要强关。确认 GPU 正常。出现启动失败或画面花屏时优先怀疑显卡Intel HD 530 及更早核显、部分 Nvidia 显卡有已知问题。按 GPU 设置指南 切换到另一块核显/独显或 Microsoft Basic Renderer效果立竿见影。打开开发者模式。WSA 设置 → 高级 → 开启 Developer mode记下显示的 IP 与端口后面的 ADB 侧载要用。可选让 WSA 访问 Windows 本机服务。需要访问localhost上的端口如本机开发的服务时按 LocalHostLoopback 指南 添加回环映射需要更多 shell 工具时按 BusyBox 指南 启用。 Root 与模块管理Magisk 怎么用、模块丢了怎么修Magisk Manager 是包内预装应用在 WSA 桌面直接打开首次按提示批准超级用户授权随后即可安装模块。KernelSU 用户则按 KernelSU 指南 单独配置。症状 → 排查模块装完不生效→ 确认模块目录结构完整模块文件夹内应有module.prop→ 在 WSA 内重启系统重新加载。重启后 Magisk 模块消失→ 这是 v2307 前后的已知问题更新到最新构建即可仍复现时查 Having Issues。想要更轻量的 root→ 改用 MagiskDelta 定制构建模块体积更小。 ADB 侧载 APK 的三步流程开启开发者模式记录 IP 和端口见上一节第 3 条。在 Windows Terminal 中执行adb pair IP:port再到 WSA 的无线调试窗口读取配对码输入完成配对随后adb connect IP:port用adb devices确认已连接。执行adb install apk路径可在文件资源管理器右键复制为路径后直接粘贴。建议第一次侧载就装一个浏览器和文件管理器之后可以直接在 WSA 里下载 Aurora Store 之类的商店应用日常安装不再依赖 ADB。完整说明见 ADB 侧载文档。 按症状排障WSA 常见故障自查打开后白屏 / 完全没有启动画面把安装目录改短C:\WSA参考 路径过长修复确认虚拟化已启用参考 虚拟化修复仍无画面时对照 WSA 安装后不启动指南应用不显示 / 装不上Google Play 侧核对 Windows 系统区域与时区设置仍异常则换 NoGApps 构建绕过 GApps 自身问题对照 Google Play 问题指南若是设置应用崩溃看 设置崩溃修复安装时脚本报错0x80073CF0 等一串错误码错误码与修复一一对应Pre-Install Issues 目录 按错误码各有一篇对照处理即可。其他杂项症状统一从 Troubleshooting 总览 入手。 数据保护与版本更新WSA 更新前必做备份什么时候该更新出现应用闪退、兼容性问题或 GApps/Magisk 有新版本时。WSABuilds 对 WSA 2311 及以上版本提供长期支持会持续跟进修复。更新前必做的备份关闭 WSA 后复制Userdata.vhdx位于%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\这个文件就是全部应用数据。更新动作下载新版本 .7z解压覆盖到原目录提示冲突时选择全部合并替换重新运行Run.bat完成覆盖安装有备份 vhdx 的按 备份与恢复指南 在关闭 WSA 状态下拷回原位置即可恢复数据完整流程见 更新指南卸载旧版则参考 Uninstallation。 社区与资源项目 Discord 社区与 GitHub Issues 是实时答疑的主渠道装之前搜一下往往已有现成答案安装文档 · FAQ · 使用指南总目录 · App 兼容性列表动手之前把 Installation.md 从头到尾读一遍能省掉后面大部分排查时间。【免费下载链接】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），仅供参考 Windows 安卓子系统 WSA 从 0 到可用的完整指南：WSABuilds 安装、Root 与排障教程
Windows 安卓子系统 WSA 从 0 到可用的完整指南WSABuilds 安装、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/WSABuildsWSABuilds 提供 Windows 10/11 的安卓子系统预构建包内置 Google Play 商店与 Magisk/KernelSU root 方案适合开发测试、应用侧载与手游大屏操作。 快速上手WSA 从下载到启动的完整动作确认系统达标。Windows 11 需 22000.526 以上版本Windows 10 建议 22H2 以上内存 8GB 起步16GB 更稳系统盘至少留 10GB 空闲空间且必须是 NTFS 分区。开启虚拟化。任务管理器 → 性能 → CPU确认虚拟化已启用未启用就进 BIOS/UEFI 打开。再按WinR输入OptionalFeatures.exe勾选 Virtual Machine Platform 与 Windows Hypervisor Platform。下载对应版本的 .7z 压缩包。项目 Releases 页面按操作系统Windows 10 / 11和架构x64 / arm64分列选与本机匹配的那一个不要下载 Source code。版本选择是这里的唯一决策点文件名含MindTheGapps的包自带 Google Play 商店与 Google Play 服务开箱即可装商店应用含NoGApps的包不带更干净适合打算用 Aurora Store 等渠道装应用的用户。两者都可用 Magisk 获取 root。解压并把文件夹改名为WSA放到路径尽量短的位置如C:\WSA。不要保留带日期、带版本号的长文件夹名过长的安装路径是 WSA 起不来的常见原因。双击文件夹里的Run.bat开始安装。脚本会自动注册 WSA 包并拉起窗口首次安装会先弹诊断信息授权对话框点同意即可。如果弹窗一闪而过、WSA 没装上改用管理员方式手动跑在管理员 PowerShell 中cd到解压目录执行PowerShell.exe -ExecutionPolicy Bypass -File .\Install.ps1。详细步骤见 安装文档。⚙️ 它是怎么跑起来的WSABuilds 技术链路速览微软的官方 WSA 本是以商店应用形式分发的WSABuilds 基于 MagiskOnWSA 的思路把 WSA 拆包成一组本地文件用Add-AppxPackage -Register AppxManifest.xml在本地直接注册运行。这样就不再依赖 Microsoft Store老版本2210 到 2407可以继续用Windows 10 也能装旧版本构建 都能找到。包内还预置了两条隐形链路libhoudini兼容层负责在 x86_64 系统上翻译运行 ARM/ARM64 应用cacerts目录提供系统证书信任链保证商店下载和应用联网正常。代价是一条硬性规则这个本地文件夹必须一直保留。WSA 是以已解包应用方式注册的删掉文件夹等于删掉系统本身升级新版本时也是把文件覆盖进同一个目录。️ 装完必做的配置WSA 安装后必做设置按使用频率从高到低前三项几乎每个用户都会用到等首次启动走完。WSA 第一次启动会初始化内部系统耗时较长中途不要强关。确认 GPU 正常。出现启动失败或画面花屏时优先怀疑显卡Intel HD 530 及更早核显、部分 Nvidia 显卡有已知问题。按 GPU 设置指南 切换到另一块核显/独显或 Microsoft Basic Renderer效果立竿见影。打开开发者模式。WSA 设置 → 高级 → 开启 Developer mode记下显示的 IP 与端口后面的 ADB 侧载要用。可选让 WSA 访问 Windows 本机服务。需要访问localhost上的端口如本机开发的服务时按 LocalHostLoopback 指南 添加回环映射需要更多 shell 工具时按 BusyBox 指南 启用。 Root 与模块管理Magisk 怎么用、模块丢了怎么修Magisk Manager 是包内预装应用在 WSA 桌面直接打开首次按提示批准超级用户授权随后即可安装模块。KernelSU 用户则按 KernelSU 指南 单独配置。症状 → 排查模块装完不生效→ 确认模块目录结构完整模块文件夹内应有module.prop→ 在 WSA 内重启系统重新加载。重启后 Magisk 模块消失→ 这是 v2307 前后的已知问题更新到最新构建即可仍复现时查 Having Issues。想要更轻量的 root→ 改用 MagiskDelta 定制构建模块体积更小。 ADB 侧载 APK 的三步流程开启开发者模式记录 IP 和端口见上一节第 3 条。在 Windows Terminal 中执行adb pair IP:port再到 WSA 的无线调试窗口读取配对码输入完成配对随后adb connect IP:port用adb devices确认已连接。执行adb install apk路径可在文件资源管理器右键复制为路径后直接粘贴。建议第一次侧载就装一个浏览器和文件管理器之后可以直接在 WSA 里下载 Aurora Store 之类的商店应用日常安装不再依赖 ADB。完整说明见 ADB 侧载文档。 按症状排障WSA 常见故障自查打开后白屏 / 完全没有启动画面把安装目录改短C:\WSA参考 路径过长修复确认虚拟化已启用参考 虚拟化修复仍无画面时对照 WSA 安装后不启动指南应用不显示 / 装不上Google Play 侧核对 Windows 系统区域与时区设置仍异常则换 NoGApps 构建绕过 GApps 自身问题对照 Google Play 问题指南若是设置应用崩溃看 设置崩溃修复安装时脚本报错0x80073CF0 等一串错误码错误码与修复一一对应Pre-Install Issues 目录 按错误码各有一篇对照处理即可。其他杂项症状统一从 Troubleshooting 总览 入手。 数据保护与版本更新WSA 更新前必做备份什么时候该更新出现应用闪退、兼容性问题或 GApps/Magisk 有新版本时。WSABuilds 对 WSA 2311 及以上版本提供长期支持会持续跟进修复。更新前必做的备份关闭 WSA 后复制Userdata.vhdx位于%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\这个文件就是全部应用数据。更新动作下载新版本 .7z解压覆盖到原目录提示冲突时选择全部合并替换重新运行Run.bat完成覆盖安装有备份 vhdx 的按 备份与恢复指南 在关闭 WSA 状态下拷回原位置即可恢复数据完整流程见 更新指南卸载旧版则参考 Uninstallation。 社区与资源项目 Discord 社区与 GitHub Issues 是实时答疑的主渠道装之前搜一下往往已有现成答案安装文档 · FAQ · 使用指南总目录 · App 兼容性列表动手之前把 Installation.md 从头到尾读一遍能省掉后面大部分排查时间。【免费下载链接】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），仅供参考