WSABuilds WSA 安装脚本 Install.ps1 完整指南:一条命令装好 Windows 11 安卓子系统(小白友好)
2026/9/9 16:29:20 网站建设 项目流程

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.ps1filelist.txtAppxManifest.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),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询