Quarkus ZIP解压提示“目标路径过长”，该如何正确处理？

关于跳过resources文件夹的影响 #

这个resources文件夹是Quarkus仓库的核心资源目录之一，里面包含框架默认配置文件、示例资源、本地化文件等关键内容。跳过解压会导致部分功能缺失——比如无法正常运行官方示例项目、部分内置配置无法加载，肯定会影响后续的Quarkus应用开发，必须处理这个问题。

解决建议 #

• 缩短解压路径：把解压目标路径改得尽可能短，比如直接放到C盘根目录下的q文件夹（如C:\q），避免使用带空格或长名称的路径，Windows默认260字符的路径长度限制很容易触发这类报错。
• 启用Windows长路径支持：
  1. 按下Win+R，输入regedit打开注册表编辑器
  2. 导航到HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem
  3. 找到LongPathsEnabled项，将其值改为1（如果没有该条目，就新建一个DWORD(32位)值并命名为LongPathsEnabled）
  4. 重启电脑后生效，即可正常解压长路径文件
• 用Git克隆仓库替代下载Zip：Git默认支持长路径，直接用命令克隆仓库能彻底避免解压问题：

  git clone https://github.com/quarkusio/quarkus.git
  

• 使用第三方解压工具：7-Zip等第三方解压工具不受Windows默认路径长度限制，用它解压Quarkus的Zip包也能解决问题。

内容的提问来源于stack exchange，提问作者Gianfranco La Rocca