Windows下Composer安装报PathTooLongException是因系统路径长度限制（260字符）所致，可通过启用长路径支持、缩短缓存路径、禁用插件脚本或改用WSL2解决。
Windows 下 Composer 安装失败提示 PathTooLongException
这是 Windows 默认路径长度限制（260 字符）导致的典型问题，尤其在嵌套较深的 vendor 目录或使用大量依赖时高频出现。根本原因不是 Composer 本身，而是 PHP 的 mkdir()、copy() 等函数调用 Windows API 时受 MAX_PATH 限制。
- 临时禁用路径限制需管理员权限运行命令：
fsutil behavior set LongPathsEnabled 1 - 该设置仅对 Windows 10 1607+ 和 Windows Server 2016+ 有效，旧系统不支持
- 即使启用长路径，部分 PHP 扩展（如某些版本的
ziparchive）仍可能因底层调用未适配而报错
用 COMPOSER_CACHE_DIR 缩短 vendor 内部路径深度
Composer 默认把包解压到项目 vendor/ 下，但实际下载的压缩包缓存在全局目录，这个缓存路径过长会加剧问题。通过重定向缓存位置，可避免多层嵌套生成超长临时路径。
- 在项目根目录执行：
set COMPOSER_CACHE_DIR=D:\ccache（Windows CMD）或$env:COMPOSER_CACHE_DIR="D:\ccache"（PowerShell） - 推荐使用短路径盘符（如
D:\），避免放在C:\Users\...这类本身就很长的用户目录下 - 该变量只影响当前终端会话；如需永久生效，添加为系统环境变量
改用 composer install --no-scripts --no-plugins 绕过高风险操作
某些插件（如 hirak/prestissimo）或脚本（如生成 autoload 文件）会在解压后触发大量文件操作，进一步拉长路径调用链。关闭它们能显著降低触发 PathTooLongException 的概率。
-
--no-scripts跳过post-install-cmd等自定义脚本，适用于纯依赖安装场景 -
--no-plugins禁用所有插件，包括加速下载类插件——虽然可能变慢，但稳定性提升明显 - 若后续需要运行脚本，可单独执行：
composer run-script post-install-cmd
终极方案：改用 WSL2 中运行 Composer
在 Windows 上启用 WSL2（如 Ubuntu），将项目放在 Linux 子系统中操作，彻底绕过 Windows 路径限制。这不是“兼容方案”，而是直接切换到无此限制的环境。
- WSL2 中的路径长度限制由 Linux 内核决定（通常为 4096），远高于 Windows
- 注意 PHP 版本需在 WSL2 内独立安装，不能复用 Windows 的
php.exe - 编辑器（如 VS Code）可通过 Remote-WSL 插件无缝连接，开发体验几乎无感
路径问题本质是平台约束，不是配置错误。最稳妥的做法是组合使用 LongPathsEnabled + COMPOSER_CACHE_DIR，复杂项目或团队协作时直接切 WSL2 更省心。
