
WSA安装报错速查WSABuilds 6类安装失败错误代码逐一给出解决路径【免费下载链接】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 是一个把 Android 子系统Windows Subsystem for Android简称 WSA做成即装即用预构建包的开源项目基于 Windows 10 和 Windows 11可选带 Google Play 商店的 GApps 版本以及 Magisk / KernelSU 两种 root 方案。WSA 安装失败大多不是出在装这个动作上而是卡在解压、脚本执行、包注册这三个环节——错误码 0x80073CF6、0x80073D10、路径太长、登录会话不存在这类提示基本都对应一个可确认的具体原因。你只需要对照本文找到对应章节按步骤操作就能把绝大多数安装失败问题处理掉。安装前快速自查先确认你属于哪种情况 动手修错之前先花一分钟定位你的问题类型直接跳到对应章节双击 Run.bat 后弹出黑窗口提示以 0x 开头的十六进制错误码 → 按代码跳到「按错误代码查解决路径」中的对应小节没有错误码黑窗口一闪而过或者提示 Install.ps1 找不到、文件缺失 → 跳到「Install.ps1 无法执行或找不到」安装脚本跑完了但 WSA 打不开、没有启动画面、开始菜单里看不到应用图标 → 跳到「装完后 WSA 打不开、无启动画面」提示与虚拟化、Hypervisor、虚拟内存平台相关 → 跳到「虚拟化报错」解压 .7z / .zip 时就报路径太长或运行脚本提示Internet 安全设置阻止了文件打开 → 跳到「路径太长与安全设置拦截」按错误代码查解决路径错误代码 0x80073CF6包注册失败症状运行 Run.bat 时窗口报Deployment failed with HRESULT: 0x80073CF6, Package could not be registered。问题本质Appx 包注册被系统环境挡住了。这个代码背后可能有多种原因需要先排除最常见的一批再靠日志确认具体是哪一种。操作路径确认 WSA 所在分区是 NTFS 格式exFAT 不支持注册用右键属性即可查看文件系统。重新下载完整构建包。下载中断或解压损坏都会触发这个错误。如果你之前装过 WSA先按官方卸载文档完全卸载并删除下面三个目录中所有名称包含WindowsSubsystemForAndroid的文件夹C:\ProgramData\Microsoft\Windows\AppRepositoryC:\ProgramData\Microsoft\Windows\WindowsApps%localappdata%\ProgramData\Packages重启电脑后再次运行 Run.bat。如果到这里还没好就取一份详细注册日志来定位真正的原因以管理员身份打开 PowerShell把当前目录切到 WSA 安装文件夹cd 你的WSA安装路径—— 切换到安装包所在位置。执行Add-AppxPackage -ForceApplicationShutdown -ForceUpdateFromAnyVersion -Register .\AppxManifest.xml—— 故意让注册再失败一次屏幕上会显示一个 ActivityID一串 UUID。执行Get-AppPackageLog -ActivityID 你上一步看到的UUID—— 打印出这次失败操作的完整日志。验证信号日志能正常打印出来说明诊断流程没走偏接下来按日志内容分两条路走若日志里出现0x800706D9endpoint mapper 无可用端点这是防火墙在作怪。打开 Windows 防火墙设置确认防火墙处于开启状态且使用推荐设置到服务里确认 Windows Firewall 服务正在运行如果你用第三方防火墙检查它是否允许新增规则条目。完成后重启电脑再装。若日志里出现0x80073B06启动屏幕图像无法识别若是你自己用脚本构建的包删掉旧构建含克隆的仓库重新构建若是官方预构建版本重新下载一次最新构建。两者都无效时说明是构建源的问题等待或反馈新版本。详见该错误代码的官方修复文档。错误代码 0x80073D10CPU 架构不匹配症状安装中途直接报架构不兼容无法继续。问题本质你下载了与系统 CPU 架构不符的包——最典型的是在 x64 电脑上装了 arm64 版本或反过来。WSABuilds 的 Windows 11 包分 x64 和 arm64 两种Windows 10 包为 x64。操作路径打开 设置 → 系统 → 关于查看系统类型确认你的电脑是 64 位x64还是 ARM64。回到安装文档中的下载说明按操作系统 架构重新选择对应资产下载注意不要选成 Source code。删掉之前下载错的文件用正确的包重新解压安装。验证信号下载文件的命名或所属 release 页与你的系统类型一致安装过程不再报架构错误。详见官方说明。虚拟化报错功能显示已启用却仍然失败症状WSA 无法启动或安装失败提示与虚拟化相关任务管理器里虚拟化明明显示已启用相关功能也都勾了。问题本质Hyper-V 相关组件的状态残留冲突——某些功能曾经开关过留下了不一致的内核启动状态WSA 反而起不来。操作路径按官方虚拟化修复文档完整走一遍顺序不能乱卸载 WSA右键Windows Subsystem for Android Settings选卸载并删除解压出来的 WSA 安装文件夹。打开启用或关闭 Windows 功能WinR 输入optionalfeatures.exe把 Hyper-V、Virtual Machine Platform、Windows Hypervisor Platform、Windows Subsystem for Linux 四项全部取消勾选重启。进 BIOS 把虚拟化临时关闭保存重启同时在 Windows 安全中心 → 应用和浏览器控制 → 威胁和防护 → 漏洞利用保护 里确认控制流保护是开启的。以管理员身份打开 CMD执行bcdedit /set hypervisorlaunchtype auto—— 让 Hypervisor 随系统自动启动消除启动方式残留。回到启用或关闭 Windows 功能把刚才取消的四项重新勾选再重启一次。进 BIOS 把虚拟化重新打开重启。重新解压 WSA 包运行 Run.bat 安装。验证信号任务管理器 → 性能中虚拟化显示已启用且 WSA 图标能正常点开、出现 Android 启动画面。Install.ps1 无法执行或找不到症状双击 Run.bat 后窗口一闪而过、没弹管理员授权框或提示 Install.ps1 不是可识别的命令、文件夹里缺少文件。问题本质多半是文件夹路径太长、包含特殊字符导致脚本定位自身文件失败其次才是脚本本身没被赋予执行权限。操作路径把解压出来的文件夹改名为短名称例如把一长串版本字符串改成WSA路径越长风险越大这是官方文档明确建议的做法。右键该文件夹 → 显示更多选项 → 复制为路径拿到干净的完整路径。按 WinX选择 Windows 终端管理员或 PowerShell管理员。输入cd 上一步复制的路径回车 —— 进入安装目录。输入PowerShell.exe -ExecutionPolicy Bypass -File .\Install.ps1回车 —— 以旁路执行策略的方式手动运行安装脚本。验证信号脚本逐行执行并在结束后 WSA 自动启动若出现首次运行的诊断信息同意弹窗点 OK 即可出现两个相同弹窗属正常都确认。Specified Logon Session Does Not Exist指定的登录会话不存在症状安装时弹出这条英文提示包没有装上去。问题本质你当前使用的不是 Windows 管理员账户。未签名的 MSIX 包无法在非管理员账户下安装这是系统限制。操作路径打开 CMD输入net localgroup administrators回车 —— 列出本机管理员组成员。确认你当前登录的账户在列表里不在的话先切换到管理员账户。用管理员账户右键 Run.bat → 以管理员身份运行手动跑 Install.ps1 时同理终端本身必须是管理员终端。验证信号命令输出里能看到你的账户名且之后安装不再报登录会话错误。路径太长与安全设置拦截症状解压 .7z 时报 Path is too long或运行脚本时提示 Your Internet security settings prevented one or more files from opening。问题本质构建包默认命名极长叠加较长的存放路径后超出 Windows 的 260 字符路径上限安全设置拦截则是同样的长路径触发系统安全策略的误判。操作路径把 .7z / .zip 压缩包本身改短名例如WSA.7z。把解压出来的文件夹也改成短名例如WSA并尽量放在层级浅的位置如D:\WSA。重新运行 Run.bat。验证信号解压完整无报错脚本正常进入安装流程。参考路径问题与安全设置拦截两篇官方文档。装完后 WSA 打不开、无启动画面症状安装流程走完了但 WSA 应用无法启动设置里打开 Files 没有启动画面Android 应用也没有图标。问题本质官方文档标注原因为未知但社区反复验证过的有效修复手段只有一个——安装文件夹名字过长导致组件无法加载。操作路径把 WSA 安装文件夹重命名为短名称如WSA。重新运行文件夹里的 Run.bat 重新注册。验证信号WSA 能弹出启动画面应用列表出现图标。详见官方文档。安装前环境与文件检查清单✅ 下载并安装前逐项确认以下事项能避开一半以上的失败案例系统版本Windows 11 为 Build 22000.526 或更高Windows 10 为 22H210.0.19045.2311或更高Win10 用winver命令查看版本内存8GB 为最低要求16GB 体验更稳系统盘C:至少 10GB 可用空间优先 SSDWSA 将安装到 NTFS 分区——右键分区属性确认文件系统exFAT 不行启用或关闭 Windows 功能中已勾选 Virtual Machine Platform 与 Windows Hypervisor Platform并已重启BIOS/UEFI 中虚拟化已开启任务管理器 → 性能 → CPU 下方可见虚拟化已启用你用的不是魔改精简版系统ReviOS、Tiny 10/11 等移除过组件的系统安装容易失败已确认系统架构x64 / arm64将要下载的包与之匹配如果此前装过官方 WSA 或其他 WSA 构建已完全卸载两套不能并存下载完成后备份了 .7z 文件解压时用 7-Zip 等专用工具不要用资源管理器右键解压长命名包常见误区与后续维护❌不要删除 WSA 安装文件夹。WSABuilds 是注册式安装Add-AppxPackage 只是把已解压的文件夹注册成应用删掉文件夹 直接报废需要整包重装。❌不要在 exFAT 分区安装。注册环节对文件系统有硬性要求这类失败没有补救手段只能换盘重装。❌不要用普通账户跑安装。非管理员账户装未签名 MSIX 必然失败即上文登录会话错误装之前先确认账户。❌不要混装。官方 WSA 与 WSABuilds 不能共存升级时也是先卸载旧版再装新版更新文档说明了合并文件夹替换文件的做法别图省事新旧并存。⚠️留意 GApps 版本的已知问题项目 README 提示 2025 年 6 月之后Windows 11 上的 GApps 构建存在崩溃问题官方修复进行中。如果你不需要 Google Play直接选文件名带NoGApps的构建更省心需要 GApps 的用户可参考 README 顶部给出的临时方案。装好之后的健康维护大版本更新前先备份%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\userdata.vhdx你的 Android 数据都在这一个文件里恢复方法见备份与恢复文档。更新走合并文件夹、替换同名文件的流程跑一次 Run.bat 重新注册即可无需重装。偶尔可以检查 WSA 设置应用能否正常打开、ADB 调试是否可用作为子系统健康的快速体检。遇到新错误先按 0x80073CF6 一节的方法取 Get-AppPackageLog 日志比盲目重装有效得多。【免费下载链接】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),仅供参考