WSABuilds 安装排障：修复解压 WSA 压缩包时 “Path is too long“（路径过长）错误

WSABuilds 安装排障修复解压 WSA 压缩包时 Path is too long路径过长错误【免费下载链接】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本文针对 WSABuilds基于 MagiskOnWSA 的 Windows Subsystem for Android 预构建包安装流程中从 .zip/.7z 压缩包解压文件时 Windows 报出 Path is too long 错误的典型场景讲清该错误的产生原因、完整的改名修复步骤以及如何结合 Install.ps1 的校验逻辑从命名与存放路径上预防该问题帮助你在安装 WSA 前顺利完成解压这一步。一、问题现象与成因分析1.1 症状解压压缩包时提示 Path is too long在通过 WSABuilds 安装 WSA 前官方安装流程要求先下载发布包中的 .7z或 .zip压缩包并解压参见 Installation.md。若此时资源管理器或解压工具弹出 Path is too long 错误说明压缩包的完整路径长度驱动器符 目录层级 文件/文件夹名超出了 Windows 文件路径长度的上限。1.2 为什么会发生MagiskOnWSALocal 生成的命名过长的压缩包原始文档 FixPathTooLong.md 明确指出This issue is caused if the folder name is too long. This is the typically the case as MagiskOnWSALocal script tends to generate a long string for the .zip file and the folder within the archive.即该问题由文件夹名过长引起且这是典型情况——MagiskOnWSALocal 的构建脚本倾向于为 .zip 文件及压缩包内部文件夹生成很长的字符串。其命名中会拼接 WSA 版本、版本号、构建渠道Release/Nightly、Magisk 版本、MindTheGapps 版本、是否移除 Amazon Appstore 等全部构建信息。以文档给出的真实命名形态为例Before过长WSA_2XXX.XXXXX.X.X_XXXX_Release-Nightly-with-magisk-XXXXXXX-XXXXXX-MindTheGapps-XX.X-RemovedAmazonAfter建议WSAArchive2XXX从源码结构看这类超长命名带来的危害不止于解压失败。WSABuilds 的安装方式是非打包注册Install.ps1 最终执行Add-AppxPackage -ForceApplicationShutdown -ForceUpdateFromAnyVersion -Register .\AppxManifest.xml其注册的 Appx 包路径会落到你解压所在目录的绝对路径上。若该目录路径本身接近长度上限后续注册、资源合并等步骤同样存在失败风险因此应在解压前就把路径压短。二、解决方案两步改名完整继承原文档原文档给出的修复方案非常直接只需完成以下两步步骤 1把 .zip/.7z 压缩包改名为更短的名称名称可以任意只要足够短即可。BeforeWSA_2XXX.XXXXX.X.X_XXXX_Release-Nightly-with-magisk-XXXXXXX-XXXXXX-MindTheGapps-XX.X-RemovedAmazonAfterWSAArchive2XXX步骤 2把解压出来的文件夹改名为更短的名称BeforeWSA_2XXX.XXXXXXX_XXXX_Release-Nightly-with-magisk-XXXXXXX-XXXXXX-MindTheGapps-XX.X-RemovedAmazonAfterWSAArchive2XXX改名完成后重新解压若此前解压已部分完成建议先删掉残缺目录再重解压。改名只影响路径长度压缩包内部文件结构不变安装脚本依据的是目录内的Run.bat、Install.ps1、filelist.txt等实际内容因此短名称不会影响安装行为。实操要点短名称应尽量只保留必要的版本标识如WSAArchive2XXX避免再次堆叠渠道、root 方案等描述性字段解压位置放在层级较浅的目录如D:\WSA或文档目录一级子目录而不是多层嵌套的下载/归档子目录中Installation.md 官方文本指南中本身就建议解压 .7z 后将文件夹重命名为WSA并放到合适位置如文档目录这一命名约定与本文修复方案完全一致属于一步到位的预防做法。三、修复后如何验证安装链路完整改名并重新解压后建议按以下顺序验证确保路径过长没有造成隐性损伤确认文件齐全Install.ps1 启动时会读取filelist.txt并逐项Test-Path校验一旦发现缺文件会直接报错退出Some files are missing in the folder. Please try to build again。若解压中途被 Path is too long 打断最典型的表现就是缺文件导致安装脚本在这一步失败——这正是路径过长错误需要彻底重新解压而非局部补救的原因。确认资源合并正常安装入口 Run.bat 会以powershell.exe -ExecutionPolicy Bypass -File .\Install.ps1拉起安装Install.ps1 随后检测MakePri.ps1与makepri.exe是否存在若存在则调用 MakePri.ps1 合并pri/xml资源目录生成resources.pri。该脚本内部会遍历.xml、.pri文件并逐一Start-Process makepri.exe见 MakePri.ps1长路径环境下这些相对文件操作同样更容易出错。若合并失败脚本会提示Failed to merge resources, WSA Settings will always be in English属于可容忍的降级设置界面语言受限而非安装中断。执行安装双击Run.bat完成注册若弹出窗口未出现管理员权限询问或安装不成功可手动以管理员身份运行详见 Installation.md 第 6 步cd {X:\path\to\your\extracted\folder} PowerShell.exe -ExecutionPolicy Bypass -File .\Install.ps1四、预防建议与注意事项命名预防下载后第一时间将压缩包与解压目录改名遵循 Installation.md 推荐的WSA短目录约定从源头避开路径长度上限而非等报错后再处理目录生命周期安装完成后该目录不可删除。由于 WSA 是通过Add-AppxPackage -Register以已解包文件形式注册的目录被移动/删除会导致 WSA 无法运行——改名、挪目录等操作应在安装前完成安装过程中不要改动更新场景更新 WSA 时官方建议合并文件夹并替换同名文件此时保持目录名短而稳定始终是WSA可避免新旧版本目录混放再次拉长路径适用前提本指南针对 WSABuilds/MagiskOnWSA 预构建包的安装前解压阶段Windows 的长路径限制属于系统级行为其他软件解压同类错误也可参照缩短完整路径的思路处理。五、相关排障文档索引若按上述步骤操作后问题仍未解决可参考仓库内的配套排障文档继续排查其他安装前问题Extraction Errors、FixInstallps1、Fix Error 0x80073CF0 等问题总入口与升级排查路径Having IssuesFix Path Too Long 即列于该页的 Common Issues 清单中与 Troubleshooting同主题镜像文档仓库内另存两份副本MagiskOnWSA/docs/Fixes/FixPathTooLong.md 与 MagiskOnWSA/DLL/docs/Fixes/FixPathTooLong.md内容与本文所依据的 Documentation/Fix Guides/Pre-Install Issues/FixPathTooLong.md 一致安装主流程与命令行细节Installation。【免费下载链接】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），仅供参考