WSA 安装失败为什么总是卡在 Run.bat3 步定位错误码并完成修复【免费下载链接】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 提供了带 Google Play 和 Magisk/KernelSU 的 Windows Subsystem for AndroidWSA预构建包但在 Windows 10/11 上运行安装脚本时WSA 安装失败常常以一串错误码的形式出现。本文按安装前自检 → 安装中报错 → 安装后异常的时间线带你从看到 0x80073CF6、0x80073D10 等 WSA 报错走到安卓应用真正跑起来。30 秒定位表看到什么错误码就跳哪里报错代码 / 现象最可能原因跳到哪一节0x80073D10下载了与 CPU 架构不匹配的包架构不匹配确认系统架构并下对版本0x80073CF6Package could not be registered包注册失败多因分区格式、残留或防火墙注册失败0x80073CF6 三级排查0x80073CF6 且日志含 0x800706D9Windows 防火墙未正常启用同上分支 A0x80073CF6 且日志含 0x80073B06启动图像文件损坏或构建异常同上分支 B提示虚拟化相关错误 / WSA 打不开Hyper-V 组件状态或 BIOS 设置异常虚拟化报错与 WSA 无法启动弹窗一闪而过、Install.ps1 未运行脚本路径过长或非管理员执行安装后异常一节装上了但无图标、无启动画面安装文件夹名称过长安装后异常一节安装前自检跑 Run.bat 之前先过这 5 关WSA 安装失败里有一半其实可以在动手前排除。对照下表逐项确认项目要求为什么重要系统版本Win10 22H2 或 Win11 及以上老版本缺少 WSA 依赖的系统组件安装分区NTFS 格式exFAT 不支持 AppX 注册所需的文件特性注册时直接失败CPU 架构与下载包一致x64 配 x64ARM64 配 ARM64架构不匹配会直接报 0x80073D10BIOS 虚拟化已启用Intel VT-x / AMD SVMWSA 靠虚拟化运行安卓环境没开就起不来第三方安全软件临时关闭杀毒和防火墙拦截 AppX 注册进程会引发 0x80073CF6 类错误分区格式检查右键此电脑 → 磁盘管理看安装所在盘的格式列。查系统架构设置 → 系统 → 系统信息看系统类型。两处都不对就先改这两处再开始安装。架构不匹配确认系统架构并下对版本0x80073D10现象Run.bat 执行时报HRESULT: 0x80073D10安装中断。真正原因WSA 安装包按 CPU 架构分包在 x64 系统装 arm64 包或反过来时包管理器会直接拒绝注册。确认你的系统类型打开 设置 → 系统 → 系统信息系统类型一栏同时标注操作系统和处理器架构例如基于 x64 的操作系统。回到 WSABuilds 下载页对照下载表选择匹配项Windows 11 x64 系统选 Windows 11 x64 包Windows 10 选 Windows 10 x64 包ARM 设备选 arm64 包不要下载标注 Source code 的条目。删除旧包与解压产物重新下载并解压。解压后的目录建议改名为短名称如WSA放在 C 盘 Documents 之类路径避免中文和超长路径。重新双击Run.bat安装。怎么确认修好了脚本跑完出现 WSA 窗口首次安装会先弹诊断信息同意框说明架构问题已排除。注册失败0x80073CF6 三级排查现象执行 Run.bat 时报Deployment failed with HRESULT: 0x80073CF6, Package could not be registered。真正原因0x80073CF6 只是包注册失败的总错误码真正原因藏在详细日志里可能是分区格式、系统残留、防火墙或包文件损坏。按下面三级往下走修到哪一级就不必继续。第一级清理环境重来确认安装所在分区是 NTFS见自检表。重新下载安装包——下载中断导致的文件损坏是注册失败的高频原因。如果装过旧版 WSA先彻底卸载再删除以下目录中所有含WindowsSubsystemForAndroid的文件夹C:\ProgramData\Microsoft\Windows\AppRepositoryC:\ProgramData\Microsoft\Windows\WindowsApps%localappdata%\Packages重启电脑后重跑Run.bat。怎么确认修好了安装顺利走完并弹出 WSA 窗口。如果报同一个错进入第二级。第二级抓详细日志定位根因以上命令都需要管理员权限且要先定位到解压出的 WSA 目录。第一条命令是手动触发一次包注册它一定会失败但失败信息里带一个ActivityIdUUID这是下一道工序的钥匙看到一串类似94c065bb-5a2a-0004-...的 UUID 就算成功拿到。Add-AppxPackage -ForceApplicationShutdown -ForceUpdateFromAnyVersion -Register .\AppxManifest.xml把上一步拿到的 UUID 替换进命令。它的作用是导出这次注册操作的完整日志看到一大段日志且其中包含0x800706D9或0x80073B06等更具体的错误码就说明定位成功。Get-AppPackageLog -ActivityID 你的UUID第三级按日志里的错误码对症下药如果日志里是 0x800706D9端点映射器无可用端点——这指向 Windows 防火墙状态异常打开 Windows 安全中心确认防火墙已开启且使用推荐设置第三方防火墙同样需要开启且放行新应用。检查Windows Defender 防火墙服务是否在运行没有就设为自动并启动。重启电脑重跑安装脚本。如果日志里是 0x80073B06启动图像无法识别——包内的启动画面文件损坏如果你是用本地工具自己构建的包删掉构建产物重新构建一次如果你用的是官方预构建包重新下载最新版再试换包后仍报同样错误就把这段日志贴到项目 Issue 区求助。虚拟化报错与 WSA 无法启动现象提示虚拟化相关错误或 WSA 图标点了没反应、无法启动。真正原因WSA 依赖 Windows 的 Hyper-V 平台。BIOS 没开虚拟化当然起不来更隐蔽的一种情况是 BIOS 已开、任务管理器里也显示已启用但 Windows 的虚拟化相关功能处于互相冲突的状态需要一次重置。先做基础确认按 CtrlShiftEsc 打开任务管理器 → 性能 → CPU看虚拟化是否显示已启用如果是已禁用重启进 BIOS 找到 Intel VT-x 或 AMD SVM 选项开启即可。如果 BIOS 已开启但仍报错执行这套重置流程卸载 WSA设置 → Windows Subsystem for Android Settings → 卸载并删除你解压安装的那个 WSA 文件夹。按 WinR 输入optionalfeatures.exe把 Hyper-V、Virtual Machine Platform、Windows Hypervisor Platform、Windows Subsystem for Linux 四项全部取消勾选重启。进 BIOS 把虚拟化临时关闭重启回 Windows同时在 Windows 安全中心 → 应用和浏览器控制 → 攻击面减少ASR策略 中确认 Control Flow Guard 处于启用状态。以管理员身份打开 CMD执行下面这条命令。它的作用是重新指定引导程序默认启动 Hypervisor命令返回操作成功完成即为生效。bcdedit /set hypervisorlaunchtype auto再把第 2 步取消的四个功能全部勾回重启两次中间各重启一次BIOS 里把虚拟化重新打开最后再装一次 WSA。怎么确认修好了重新安装后 WSA 能正常弹出启动窗口且任务管理器性能页持续显示虚拟化已启用。安装后异常脚本没跑、无图标、无启动画面现象三类最常见的装上了却不对劲分别对应下面情况。如果双击 Run.bat 后弹窗一闪就没了——说明脚本没拿到管理员权限或路径过长把解压出来的文件夹改名为短名称比如WSA路径里避免中文。按 WinX选择 Windows 终端(管理员)。先切换到安装目录提示符变成该路径即算成功cd X:\你的WSA文件夹路径再执行这条命令跳过执行策略限制直接运行安装脚本看到脚本开始下载/注册进度输出即说明跑起来了PowerShell.exe -ExecutionPolicy Bypass -File .\Install.ps1如果装好后打开文件应用没有启动画面、安卓应用都没有图标——通常是安装文件夹名字过长导致。把文件夹重命名为短名如WSAArchive24然后重跑一次Run.bat重新注册即可。⚠️ 注意WSA 的注册是指向这个文件夹的安装完成后不能删除该文件夹否则 WSA 整个失效。怎么确认修好了WSA 设置应用可以打开、关于页能看到版本号启动一个安卓应用不闪退。仍然失败把日志带去找官方以上都试过还失败时别再盲改系统按这两步收集信息去项目 Issue 区发帖求助按第二级的两条 PowerShell 命令重新抓一次日志Add-AppxPackage拿到 UUIDGet-AppPackageLog导出日志。发帖时附上Windows 版本与系统类型、CPU 架构、安装分区格式、BIOS 虚拟化状态、完整的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），仅供参考
WSA 安装失败为什么总是卡在 Run.bat？3 步定位错误码并完成修复
WSA 安装失败为什么总是卡在 Run.bat3 步定位错误码并完成修复【免费下载链接】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 提供了带 Google Play 和 Magisk/KernelSU 的 Windows Subsystem for AndroidWSA预构建包但在 Windows 10/11 上运行安装脚本时WSA 安装失败常常以一串错误码的形式出现。本文按安装前自检 → 安装中报错 → 安装后异常的时间线带你从看到 0x80073CF6、0x80073D10 等 WSA 报错走到安卓应用真正跑起来。30 秒定位表看到什么错误码就跳哪里报错代码 / 现象最可能原因跳到哪一节0x80073D10下载了与 CPU 架构不匹配的包架构不匹配确认系统架构并下对版本0x80073CF6Package could not be registered包注册失败多因分区格式、残留或防火墙注册失败0x80073CF6 三级排查0x80073CF6 且日志含 0x800706D9Windows 防火墙未正常启用同上分支 A0x80073CF6 且日志含 0x80073B06启动图像文件损坏或构建异常同上分支 B提示虚拟化相关错误 / WSA 打不开Hyper-V 组件状态或 BIOS 设置异常虚拟化报错与 WSA 无法启动弹窗一闪而过、Install.ps1 未运行脚本路径过长或非管理员执行安装后异常一节装上了但无图标、无启动画面安装文件夹名称过长安装后异常一节安装前自检跑 Run.bat 之前先过这 5 关WSA 安装失败里有一半其实可以在动手前排除。对照下表逐项确认项目要求为什么重要系统版本Win10 22H2 或 Win11 及以上老版本缺少 WSA 依赖的系统组件安装分区NTFS 格式exFAT 不支持 AppX 注册所需的文件特性注册时直接失败CPU 架构与下载包一致x64 配 x64ARM64 配 ARM64架构不匹配会直接报 0x80073D10BIOS 虚拟化已启用Intel VT-x / AMD SVMWSA 靠虚拟化运行安卓环境没开就起不来第三方安全软件临时关闭杀毒和防火墙拦截 AppX 注册进程会引发 0x80073CF6 类错误分区格式检查右键此电脑 → 磁盘管理看安装所在盘的格式列。查系统架构设置 → 系统 → 系统信息看系统类型。两处都不对就先改这两处再开始安装。架构不匹配确认系统架构并下对版本0x80073D10现象Run.bat 执行时报HRESULT: 0x80073D10安装中断。真正原因WSA 安装包按 CPU 架构分包在 x64 系统装 arm64 包或反过来时包管理器会直接拒绝注册。确认你的系统类型打开 设置 → 系统 → 系统信息系统类型一栏同时标注操作系统和处理器架构例如基于 x64 的操作系统。回到 WSABuilds 下载页对照下载表选择匹配项Windows 11 x64 系统选 Windows 11 x64 包Windows 10 选 Windows 10 x64 包ARM 设备选 arm64 包不要下载标注 Source code 的条目。删除旧包与解压产物重新下载并解压。解压后的目录建议改名为短名称如WSA放在 C 盘 Documents 之类路径避免中文和超长路径。重新双击Run.bat安装。怎么确认修好了脚本跑完出现 WSA 窗口首次安装会先弹诊断信息同意框说明架构问题已排除。注册失败0x80073CF6 三级排查现象执行 Run.bat 时报Deployment failed with HRESULT: 0x80073CF6, Package could not be registered。真正原因0x80073CF6 只是包注册失败的总错误码真正原因藏在详细日志里可能是分区格式、系统残留、防火墙或包文件损坏。按下面三级往下走修到哪一级就不必继续。第一级清理环境重来确认安装所在分区是 NTFS见自检表。重新下载安装包——下载中断导致的文件损坏是注册失败的高频原因。如果装过旧版 WSA先彻底卸载再删除以下目录中所有含WindowsSubsystemForAndroid的文件夹C:\ProgramData\Microsoft\Windows\AppRepositoryC:\ProgramData\Microsoft\Windows\WindowsApps%localappdata%\Packages重启电脑后重跑Run.bat。怎么确认修好了安装顺利走完并弹出 WSA 窗口。如果报同一个错进入第二级。第二级抓详细日志定位根因以上命令都需要管理员权限且要先定位到解压出的 WSA 目录。第一条命令是手动触发一次包注册它一定会失败但失败信息里带一个ActivityIdUUID这是下一道工序的钥匙看到一串类似94c065bb-5a2a-0004-...的 UUID 就算成功拿到。Add-AppxPackage -ForceApplicationShutdown -ForceUpdateFromAnyVersion -Register .\AppxManifest.xml把上一步拿到的 UUID 替换进命令。它的作用是导出这次注册操作的完整日志看到一大段日志且其中包含0x800706D9或0x80073B06等更具体的错误码就说明定位成功。Get-AppPackageLog -ActivityID 你的UUID第三级按日志里的错误码对症下药如果日志里是 0x800706D9端点映射器无可用端点——这指向 Windows 防火墙状态异常打开 Windows 安全中心确认防火墙已开启且使用推荐设置第三方防火墙同样需要开启且放行新应用。检查Windows Defender 防火墙服务是否在运行没有就设为自动并启动。重启电脑重跑安装脚本。如果日志里是 0x80073B06启动图像无法识别——包内的启动画面文件损坏如果你是用本地工具自己构建的包删掉构建产物重新构建一次如果你用的是官方预构建包重新下载最新版再试换包后仍报同样错误就把这段日志贴到项目 Issue 区求助。虚拟化报错与 WSA 无法启动现象提示虚拟化相关错误或 WSA 图标点了没反应、无法启动。真正原因WSA 依赖 Windows 的 Hyper-V 平台。BIOS 没开虚拟化当然起不来更隐蔽的一种情况是 BIOS 已开、任务管理器里也显示已启用但 Windows 的虚拟化相关功能处于互相冲突的状态需要一次重置。先做基础确认按 CtrlShiftEsc 打开任务管理器 → 性能 → CPU看虚拟化是否显示已启用如果是已禁用重启进 BIOS 找到 Intel VT-x 或 AMD SVM 选项开启即可。如果 BIOS 已开启但仍报错执行这套重置流程卸载 WSA设置 → Windows Subsystem for Android Settings → 卸载并删除你解压安装的那个 WSA 文件夹。按 WinR 输入optionalfeatures.exe把 Hyper-V、Virtual Machine Platform、Windows Hypervisor Platform、Windows Subsystem for Linux 四项全部取消勾选重启。进 BIOS 把虚拟化临时关闭重启回 Windows同时在 Windows 安全中心 → 应用和浏览器控制 → 攻击面减少ASR策略 中确认 Control Flow Guard 处于启用状态。以管理员身份打开 CMD执行下面这条命令。它的作用是重新指定引导程序默认启动 Hypervisor命令返回操作成功完成即为生效。bcdedit /set hypervisorlaunchtype auto再把第 2 步取消的四个功能全部勾回重启两次中间各重启一次BIOS 里把虚拟化重新打开最后再装一次 WSA。怎么确认修好了重新安装后 WSA 能正常弹出启动窗口且任务管理器性能页持续显示虚拟化已启用。安装后异常脚本没跑、无图标、无启动画面现象三类最常见的装上了却不对劲分别对应下面情况。如果双击 Run.bat 后弹窗一闪就没了——说明脚本没拿到管理员权限或路径过长把解压出来的文件夹改名为短名称比如WSA路径里避免中文。按 WinX选择 Windows 终端(管理员)。先切换到安装目录提示符变成该路径即算成功cd X:\你的WSA文件夹路径再执行这条命令跳过执行策略限制直接运行安装脚本看到脚本开始下载/注册进度输出即说明跑起来了PowerShell.exe -ExecutionPolicy Bypass -File .\Install.ps1如果装好后打开文件应用没有启动画面、安卓应用都没有图标——通常是安装文件夹名字过长导致。把文件夹重命名为短名如WSAArchive24然后重跑一次Run.bat重新注册即可。⚠️ 注意WSA 的注册是指向这个文件夹的安装完成后不能删除该文件夹否则 WSA 整个失效。怎么确认修好了WSA 设置应用可以打开、关于页能看到版本号启动一个安卓应用不闪退。仍然失败把日志带去找官方以上都试过还失败时别再盲改系统按这两步收集信息去项目 Issue 区发帖求助按第二级的两条 PowerShell 命令重新抓一次日志Add-AppxPackage拿到 UUIDGet-AppPackageLog导出日志。发帖时附上Windows 版本与系统类型、CPU 架构、安装分区格式、BIOS 虚拟化状态、完整的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），仅供参考
 L2 适配器：配置参数、环境变量回退与源码实现解析)
