启用Windows长路径支持可解决Composer安装时的“File path too long”错误，依次可通过组策略或注册表开启长路径功能，再结合调整Composer缓存目录、使用短路径符号链接或WSL环境彻底规避路径长度限制。
Windows系统对文件路径长度默认限制为260个字符，当使用Composer安装依赖时，深层嵌套的vendor目录结构很容易超出该限制，导致“File path too long”错误。这个问题在PHP项目中较为常见，尤其在依赖较多的Laravel或Symfony项目中。
启用Windows长路径支持
从Windows 10版本1607开始，系统支持超过260字符的路径，但需要手动开启：
如果你使用的是Windows家庭版，没有组策略编辑器，可通过注册表修改：
- 按 Win+R，输入 regedit
- 定位到：
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem - 将
LongPathsEnabled的值设为 1
调整Composer缓存和安装路径
将Composer的全局缓存和项目依赖安装路径改到短路径位置，可有效规避问题：
- 修改Composer的缓存目录：
composer config --global cache-dir "C:/c" - 或将整个
vendor目录映射到短路径，例如在项目根目录执行：
composer config vendor-dir "../v"
这样依赖会安装到项目外一个较短路径下，避免深层嵌套。
使用符号链接缩短实际路径
将项目放在如 C:\p\myproject 这样的短路径下，并用命令提示符创建符号链接：
- 打开管理员权限的CMD或PowerShell
- 执行：mklink /D C:\p\myproject D:\your\actual\long\project\path
- 然后在
C:\p\myproject中运行Composer命令
这样Composer操作的是短路径下的链接，实际文件仍位于原位置。
使用WSL（Windows Subsystem for Linux）
在WSL环境中运行Composer完全避开Windows路径限制：
- 安装WSL（推荐Ubuntu）
- 将项目放在Linux子系统目录中，如
/home/user/project - 在WSL终端中使用Composer，不再受Windows MAX_PATH限制
这是最彻底的解决方案，尤其适合长期进行PHP开发的用户。
基本上就这些方法。启用长路径支持是最直接的修复方式，配合调整缓存或使用WSL能从根本上避免问题。不复杂但容易忽略。
