WSABuilds WSA 安装脚本 Install.ps1 完整指南:一条命令装好 Windows 11 安卓子系统(小白友好)
【免费下载链接】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 11 上装安卓应用,不像手机那样点一下 APK(安卓安装包)就行,商店里也没有现成的安卓 App 可点。开源项目 WSABuilds 的 WSA 安装脚本Install.ps1把这件事自动化了:它装的是内置 Google Play 的 WSA(Windows 11 里的安卓子系统)预制包,脚本会自动完成注册和配置,你只需要用管理员权限在 PowerShell(Windows 自带的命令窗口)里跑一下。
先看结论
- 适合谁:想在 Windows 11 上跑安卓应用的普通用户,或需要可 root(Magisk 方案)安卓环境的开发者
- 能干什么:一键装好预制 WSA,自带 Google Play,装完就能用
- 前置条件:Windows 11、管理员权限、虚拟化已开启
- 大概花多久:5 到 15 分钟(不含开启虚拟机平台后那次重启的等待)
- 需要准备什么:WSABuilds 安装包(里面有
Install.ps1和 WSA 包文件)
🧾 安装前 WSA 环境检查清单
WSA 安装前对照下面几项过一遍,能少踩很多坑:
| 检查项 | 要求 | 如何确认 |
|---|---|---|
| 系统版本 | Windows 11(WSA 只在 Windows 11 上运行) | 设置 → 系统 → 关于,看系统版本 |
| 管理员权限 | WSA 需要管理员权限 | PowerShell 窗口标题栏带"管理员" |
| 虚拟化 | BIOS 里虚拟化已开启 | 任务管理器 → 性能页,看"虚拟化:已启用" |
| 虚拟机平台 | Windows 功能需启用(没开脚本会自动开) | 搜索"启用或关闭 Windows 功能",看该项是否勾选 |
| 磁盘空间 | 至少 16GB 可用 | 此电脑里看盘符剩余空间 |
| 脚本文件完整 | 包内文件齐全 | 不用手动查,脚本会自动校验 |
🔧 WSA 手把手安装步骤(Install.ps1 实操)
安装包里有三个脚本变体:主脚本在MagiskOnWSA/installer/目录,x64/和arm64/子目录下是各架构的专门版本。普通桌面电脑直接用主脚本即可,不用纠结。
第一步 获取安装包并解压
你要做什么:下载最新的 WSABuilds 安装包,解压到一个路径较短的目录。WSA 的安装路径有长度限制,别用深层嵌套目录。
你会看到什么:解压后的文件夹里有Install.ps1、filelist.txt、AppxManifest.xml(描述包内容和依赖的文件)。
如果没看到怎么办:文件不全时脚本运行会直接报错,重新下载解压即可。
第二步 用管理员权限打开 PowerShell
你要做什么:在 Windows 11 搜索框输入 PowerShell,右键搜索结果选"以管理员身份运行"。
你会看到什么:窗口打开,标题栏带"管理员"。
如果没看到怎么办:WSA 需要管理员权限,关掉后按上面的方式重新打开。
第三步 运行 WSA 安装脚本
你要做什么:在 PowerShell 里进入安装包所在文件夹,执行powershell -ExecutionPolicy Bypass -File .\Install.ps1;或者更省事,直接双击包里的Run.bat。
你会看到什么:窗口标题变成 Installing MagiskOnWSA,脚本会自动依次打印校验文件、启用虚拟机平台、安装依赖、注册 WSA。
如果没看到怎么办:开头就提示 Some files are missing,重新解压;提示 Need restart to enable virtual machine platform,就按 y 重启后再次运行。
第四步 等待安装完成
你要做什么:遇到重启提示按 y,其余时间等待即可。
你会看到什么:出现 All Done,WSA 窗口直接打开,同时拉起 Google Play。
如果没看到怎么办:停在某个报错上,按下面的常见问题自查。
🧠 WSA 安装脚本幕后机制速览
管理员提权:脚本先检查自己是否以管理员权限运行,不是的话会自动提权重启自己。对应代码就一行Start-Process -Verb RunAs ...,你不需要手动做什么。
文件自检:脚本会逐个读取包里的filelist.txt,确认安装材料齐不齐,缺文件就停下来提示你重新解压。这一步能挡掉大多数"装到一半失败"的情况。
启用虚拟机平台:WSA 本质是个虚拟化环境,依赖系统里的"虚拟机平台"功能。脚本会检查该功能状态,没开就自动启用,对应Enable-WindowsOptionalFeature -FeatureName 'VirtualMachinePlatform'。这个功能要重启才生效,所以这里会出现重启提示,属于正常流程。
注册表解锁开发模式:为了让 WSA 不用申请开发者许可证就能跑,脚本会自动往注册表写一项AllowDevelopmentWithoutDevLicense。这就是装完即用、不用找微软申请许可的原因。
包注册与升级:真正的安装命令是Add-AppxPackage(把应用注册进系统的命令)。装之前脚本会先读AppxManifest.xml,逐个比对依赖包版本,已装的太旧就先升级,再注册 WSA 本体。
失败回滚:如果升级已存在的 WSA 失败,脚本会提供保留用户数据的卸载选项,然后重试安装。也就是说升级翻车时,你已装的应用和数据不会丢。
❓ WSA 安装失败怎么办:常见问题自查
安装报错怎么办
多为文件不全或权限不足。提示 Some files are missing 就重新解压安装包;报权限错误或窗口直接闪退,就右键以管理员身份重新运行。
为什么 WSA 安装提示重启
正常现象。脚本刚帮你开启了"虚拟机平台",这个 Windows 功能要重启才生效。按 y 重启后重新跑一次脚本即可。
已装过 WSA 有冲突怎么办
脚本会弹窗让你选,按 y 让它先卸载旧版再装新的。WSA 只支持单实例,脚本不会强行覆盖;升级失败时它会自动保留用户数据重试,不用手动处理。
Windows Terminal 下的兼容问题
看到 Dependency should be installed but Windows Terminal is in use 就先别动。Windows Terminal 环境下装依赖包受限,脚本会自动切到传统控制台 conhost 重开窗口继续跑,跟着新窗口等就行。
✅ WSA 装完之后建议做这几件事
- 打开 WSA 应用,检查语言、网络和存储设置是否正常
- 登录 Google Play,装一两个常用应用验证
- 需要 root 的话,在 WSA 里打开 Magisk 确认 root 生效
- 常用 ADB(安卓调试桥)调试的话,在 WSA 设置 → 开发者选项里打开它
- 把 WSA 数据放在空间充足的盘上,安卓应用和缓存占空间不小
- 保留安装包文件夹,以后升级重装用得上
WSABuilds 的 WSA 安装脚本把最繁琐的部分变成了几次按键:文件校验、依赖安装、包注册和失败重试都由脚本代劳,你只负责在关键节点按键。想在 Windows 11 上跑安卓应用,或只是偶尔需要安卓环境,这是一条不用双系统、不用虚拟机就能走通的路。遇到新情况,可以翻一下项目 Documentation 目录里的排障指南。
【免费下载链接】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),仅供参考