启用Windows长路径支持可解决Composer安装时的“File path too long”错误，依次可通过组策略或注册表开启长路径功能，再结合调整Composer缓存目录、使用短路径符号链接或WSL环境彻底规避路径长度限制。
Windows系统对文件路径长度默认限制为260个字符，当使用Composer安装依赖时，深层嵌套的vendor目录结构很容易超出该限制，导致“File path too long”错误。这个问题在PHP项目中较为常见，尤其在依赖较多的Laravel或Symfony项目中。
启用Windows长路径支持
从Windows 10版本1607开始，系统支持超过260字符的路径，但需要手动开启：
- 打开“组策略编辑器”（按 Win+R，输入 gpedit.msc）
- 导航到：计算机配置 → 管理模板 → 系统 → 文件系统
- 双击“启用Win32长路径”，设置为“已启用”
- 保存并重启电脑
如果你使用的是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"
这样依赖会安装到项目外一个较短路径下，避免深层嵌套。
windows-auto
下载
Windows 桌面自动化技能，支持鼠标控制（移动/点击/拖拽/滚轮/截图）、键盘输入（文字输入/按键/组合键）、窗口管理（查找/聚焦/最大化/最小化/关闭/移动）、截图并发送文件。提供两种截图方式：Python pyautogui 截图（集成在自动化流程中）和 PowerShell + .NET 零依赖截图（支持区域截图和多显示器）。当用户需要自动化 Windows 桌面操作、控制鼠标键盘、管理窗口、执行 GUI 自动化任务、截图发送文件时使用。
使用符号链接缩短实际路径
将项目放在如 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能从根本上避免问题。不复杂但容易忽略。
