必须先启用windows长路径支持（longpathsenabled=1），否则其他配置均无效；需通过fsutil或注册表启用并重启终端，再配合composer_cache_dir设短路径、vendor-dir外移、--no-scripts安装及升级composer 2.2+和php 7.4+。
必须先启用 Windows 的 LongPathsEnabled
不开启这个系统级开关，其他所有 Composer 配置都只是临时缓解，甚至无效。Windows 10 1607+ 和 Windows Server 2016+ 支持该功能，但默认关闭。
管理员权限下运行：fsutil behavior set LongPathsEnabled 1（推荐，适用于所有版本）
或修改注册表：HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem\LongPathsEnabled 设为 DWORD=1
注意：修改后必须重启终端（CMD/PowerShell/Git Bash）或整个系统，否则 composer install 仍会报 PathTooLongException
验证是否生效：在 PowerShell 中运行 fsutil behavior query LongPathsEnabled，返回 enabled 才算成功
COMPOSER_CACHE_DIR 必须设成短路径
Composer 下载包时先解压到全局缓存目录，再复制进 vendor/。这个缓存路径如果本身就很长（比如落在 C:\Users\... 下），会叠加嵌套层级，极易触发限制。
执行以下命令（CMD）：set COMPOSER_CACHE_DIR=D:\ccache
或（PowerShell）：$env:COMPOSER_CACHE_DIR="D:\ccache"
更推荐永久设置：
• 新建短路径如 D:\c
• 运行 setx COMPOSER_CACHE_DIR "D:\c"
• 关闭并重开终端
不要用 C:\Users\... 或 OneDrive 同步目录——这些前缀本身就接近 100 字符，留给 vendor 的空间所剩无几
vendor 目录位置和安装参数要配合调整
即使开了长路径，深层嵌套仍可能被 Git、PHP zip 扩展或 IDE 的文件监听机制误判失败。
可主动压平路径结构：
• 在项目根目录运行：composer config vendor-dir "../v"，把 vendor 移到项目外的短路径
• 或直接把项目放在 D:\p\myapp 这类极短路径下，避免前缀过长
安装时跳过高风险环节：
• composer install --no-scripts --no-plugins 先完成基础解压
• 再单独运行：composer dump-autoload 和 composer run-script post-install-cmd
慎用 --prefer-source：它会克隆完整 Git 仓库，路径比 --prefer-dist 长得多，更容易超限
Composer 版本和 PHP 扩展兼容性不能忽略
LongPathsEnabled 只对明确声明支持的应用生效。Composer 2.2+ 通过 app.manifest 声明了兼容性；2.1- 或 1.x 版本即使开了注册表也无效。
检查当前版本：composer --version，低于 2.2.0 必须升级：composer self-update
某些 PHP 扩展（如旧版 ziparchive）底层调用未适配长路径，会导致解压失败。若仍报错 failed to open stream，尝试：
• 确认 PHP 使用的是官方 VC15/VC17 编译版（非 XAMPP 自带旧版）
• 或临时禁用 zip 扩展，让 Composer 回退到 php://temp 流式解压
最彻底的规避方式是 WSL2：把项目放在 Ubuntu 子系统里，路径长度限制由 Linux 内核控制（默认 4096），且无需任何配置。VS Code 的 Remote-WSL 插件能无缝衔接，开发体验几乎无感
