WSABuildsWSA 突然罢工WSA Stopped Working的完整修复与虚拟化环境重置指南【免费下载链接】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 Subsystem for AndroidWSA此前运行正常某次更新或系统变动后突然无法启动、界面卡死或点击无响应官方文档将其称为 WSA Stopped Working!。本文基于仓库内 WSA Stopped Working!.md 修复指南展开完整讲解该故障的 10 步修复流程Windows 功能开关、BIOS 虚拟化切换、Control Flow Guard、FsDepends注册表项、bcdedit引导项重置并结合仓库中 Run.bat 与 Install.ps1 的源码说明修复后如何正确重新拉起 WSA读完你可以独立完成一套虚拟化栈完全重置 WSA 重新注册的实战操作。故障表现正常运行的 WSA 突然失效该文档针对的典型场景是WSA 一直在你的电脑上正常工作但突然某一天它就坏了——启动失败、闪退或完全没有响应而你没有做任何显式的改动。这类问题通常不是 WSA 包本身损坏而是 Windows 的虚拟化相关组件Hypervisor 启动方式、虚拟机平台特性、BIOS 虚拟化开关、安全加固项状态出现不一致导致 WSA 依赖的底层虚拟化环境失效。文档原文用一句话概括了这个处境WSA has been working fine for you, but all of a sudden, it breaks/stops working. 对应的处理思路是先把 Windows 侧的虚拟化环境干净地拆掉再按正确顺序重新装回去最后通过安装器重新拉起 WSA。修复流程总览完整修复共 10 步可按四个阶段理解阶段步骤目的一、拆除1–4禁用四个 Windows 虚拟化特性 → 重启 → BIOS 关闭虚拟化 → 确认 Control Flow Guard 开启让系统回到无 Hypervisor 活动的干净基线二、修正关键项5–6修改FsDepends服务的Start值 → 以管理员 CMD 执行bcdedit命令修正已知的会阻止 WSA 启动的配置缺陷三、重建7–9重新启用步骤 1 禁用的特性 → 重启 → BIOS 开启虚拟化 → 再次重启按正确顺序恢复完整虚拟化栈四、验证10运行Run.bat或通过 WSA 设置应用重新启动确认 WSA 恢复正常下面逐步展开每一步都保留原文档的具体操作要点并补充可核验的依据。阶段一拆除 Windows 虚拟化组件并建立干净基线步骤 1在启用或关闭 Windows 功能中禁用四项特性打开启用或关闭 Windows 功能Turn Windows features on and off检查以下四个特性凡是已启用的全部禁用Hyper-VVirtual Machine Platform虚拟机平台Windows Hypervisor PlatformWindows Subsystem for Linux这四者都直接或间接挂在 Windows Hypervisor 之上。同时禁用它们的意义在于彻底停掉 Hypervisor 的占用避免残留的 Hypervisor 会话/驱动状态干扰后续重置。步骤 2重启电脑禁用特性需要重启才能完全生效此步不可跳过。步骤 3进入 BIOS 关闭虚拟化Virtualization重启时进入 BIOS将 CPU 虚拟化开关Intel VT-x / AMD-V 对应的项关闭。原文档为此提供了 Windows 11 与 Windows 10 两个平台的官方 BIOS 虚拟化设置指引微软支持文档《Enable virtualization on your Windows PC》不同主板厂商的 BIOS 界面略有差异可按该指引找到对应选项。步骤 4确认 Control Flow Guard 处于开启状态在Windows 安全中心Windows Security 应用和浏览器控制Apps browser control 漏洞利用保护Exploit protection中确保Control Flow GuardCFG已启用。原文明确指出This is a known issue that can prevent WSA from starting——CFG 未开启是已知的、会直接阻止 WSA 启动的原因因此这一步是在拆的同时把这一已知问题一次性排掉。阶段二修正两个已知会卡住 WSA 的配置项步骤 5将FsDepends服务的Start值由 3 改为 0打开注册表编辑器regedit定位到HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\FsDepends将其中的Start值从3改为0即由手动启动改为自动启动。原文档特别注明You can change it back to 3, if it makes no difference—— 如果这项修改最终对你的问题没有影响可以改回 3。FsDepends是 Windows 文件系统依赖相关的服务项该值异常会影响 WSA 包在启动时挂接文件系统依赖组件因此修复指南将其列为必查项。步骤 6以管理员身份在 CMD 中执行 bcdedit以管理员身份打开命令提示符CMD执行bcdedit /set hypervisorlaunchtype auto该命令把 BCDBoot Configuration Data中的hypervisorlaunchtype设为auto含义是由系统根据已安装的 Hypervisor 组件自动决定是否启动 Hypervisor。这是整个流程中最核心的一步前面步骤 1–3 把环境拆到干净基线后用auto让 Windows 在下次启动时重新协商并正确拉起 Hypervisor而不是沿用之前可能已损坏/错位的固定值如off或旧的enabled状态。阶段三按正确顺序重建虚拟化栈步骤 7重新启用步骤 1 禁用的特性并第二次重启回到启用或关闭 Windows 功能把 Hyper-V、Virtual Machine Platform、Windows Hypervisor Platform、WSL 这些你刚才禁用的特性重新启用保持你原本的使用习惯即可然后第二次重启电脑。步骤 8在 BIOS 中重新开启虚拟化再次进入 BIOS将 Virtualization 打开原文档同样给出 Windows 11 与 Windows 10 两份官方指引入口。此时系统会以干净基线 hypervisorlaunchtype auto的状态重新初始化虚拟化层。步骤 9第三次重启电脑让所有变更Windows 特性、BIOS、BCD、注册表全部落地。阶段四重新拉起 WSA 并验证步骤 10运行Run.bat或通过 WSA 设置应用启动原文档给出的验证方式是Try re-running WSA by runningRun.bator via the Windows Subsystem for Android Settings app即两种入口任选其一运行解压目录中的Run.bat通过Windows Subsystem for Android 设置应用启动。这一步在仓库里有完整的源码依据值得展开看Run.bat 的逻辑非常简短它先切到自己的目录确认Install.ps1存在然后以-ExecutionPolicy Bypass方式调用 PowerShell 执行 Install.ps1第 28 行start powershell.exe -ExecutionPolicy Bypass -File .\Install.ps1。Install.ps1 做了与修复后重新拉起直接相关的几件事管理员校验与提权第 20–27、66–81 行用WindowsIdentity::GetCurrent()判断当前用户是否属于 Administrators 组若不是则通过Start-Process -Verb RunAs重新以管理员身份拉起自身自动补齐虚拟机平台特性第 110–120 行检查Get-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform若未启用则自动Enable-WindowsOptionalFeature并提示重启。这也印证了为什么修复流程要关注 Virtual Machine Platform——安装器自身就依赖它是启用的依赖包版本校验第 122–142 行读取AppxManifest.xml按依赖包声明的MinVersion逐个比对已安装的 Appx 包版本不足则用Add-AppxPackage安装对应.appx注册 WSA 主包第 159–168 行先尝试WsaClient /shutdown关闭既有实例并结束残留WsaClient进程再用Add-AppxPackage -Register .\AppxManifest.xml注册开发模式包成功后Finish函数会拉起wsa://com.topjohnwu.magisk与wsa://com.android.vending两个 URI第 54–58 行升级失败时的降级重装路径第 169–178 行若覆盖注册失败且已存在旧包会提示并执行Remove-AppxPackage -PreserveApplicationData保留用户数据后重新注册。从源码结构看Run.bat这条路径本质是关闭旧实例 → 校验依赖 → 重新注册开发模式包的完整流程因此把它作为虚拟化环境重置之后的重新拉起入口是合适的。如果Run.bat路径过深、提示路径过长可参考仓库中 FixPathTooLong.md 处理。与虚拟化错误故障的边界何时该用另一篇指南仓库中另有一篇同目录文档 FixVirtError.md处理的是明确出现虚拟化错误的场景——即使 BIOS 里开了虚拟化、任务管理器里也显示已启用、且 Virtual Machine Platform Windows Hypervisor Platform 都开着WSA 仍报错。两者的流程骨架高度相似同为禁用特性 → 关 BIOS 虚拟化 → CFG 检查 → 注册表 →bcdedit→ 恢复特性 → 开 BIOS 虚拟化 → 重装但虚拟化错误版本多两处更彻底的动作可作为本指南的进阶补充前置动作是卸载原文要求先卸载 WSA右键 WSA 设置应用选择卸载并删除解压的安装文件夹多一项 DeviceGuard 注册表修正在HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\DeviceGuard下将EnableVirtualizationBasedSecurity设为0若不存在该 DWORD 值右键新建 DWORD32 位值、命名后设为 0面向 AtlasOS 用户的兜底若上述步骤仍无效到 AtlasOS 配置目录中运行 Enable Hyper-V and VBS 的 CMD 脚本重启后再试。经验法则有明确虚拟化报错 → 走 FixVirtErrorWSA 之前正常、现在突然罢工且无明确虚拟化报错 → 走本文的 10 步流程。两篇指南的共同入口都列在 Having Issues.md 的常见问题徽章导航中。仍无法恢复时的排查路径如果完整走完 10 步 WSA 依旧不工作仓库的 Troubleshooting.md 给出了下一步判断逻辑区分是 WSA 本体问题还是 WSABuilds 包问题从 Microsoft Store或官方 WSA 包仓库安装官方 WSA 测试能否正常工作。官方版本也不能用说明问题在系统/虚拟化层面应按该文档指引通过 Feedback Hub 提交报告并附完整复现步骤官方 WSA 正常但 WSABuilds 不正常优先怀疑包/安装器环节可考虑用仓库自带工具链重新安装——WSAUpdater.py 用于更新、WSAUninstaller.py 用于卸载二者位于WSABuilds Utilities/目录下以上都不适用在项目的 Issue 区或官方 Discord 社区求助Troubleshooting.md 与原文档末尾都指向该渠道。小结与操作要点核对清单整套修复的本质是虚拟化栈的完全重置拆除 → 修正两个已知缺陷CFG、FsDepends、hypervisorlaunchtype→ 按顺序重建 → 用安装器重新注册。执行后可按此清单自查四个特性Hyper-V / Virtual Machine Platform / Windows Hypervisor Platform / WSL是否经历了禁用 → 重启 → 再启用 → 再重启的完整循环BIOS 虚拟化是否经历了关闭 → 开启的完整循环且中间执行过bcdedit /set hypervisorlaunchtype autoWindows 安全中心的 Control Flow Guard 是否已确认开启HKLM\SYSTEM\CurrentControlSet\Services\FsDepends的Start是否已改为 0最后是否通过Run.bat其底层为 Install.ps1 的依赖校验 开发模式包注册流程或 WSA 设置应用成功拉起了 WSA。只要按此顺序完成绝大多数WSA 突然罢工的场景都能恢复若个别机器对FsDepends改动无感知可按原文档提示将其改回 3不影响最终状态。【免费下载链接】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），仅供参考