优先启用Windows长路径支持并缩短项目路径，可解决Composer因路径过长导致的“File path too long”错误；具体措施包括：开启组策略或注册表中的LongPathsEnabled、将项目移至磁盘根目录如C:\p\、使用mklink创建vendor目录符号链接，以及设置COMPOSER_CACHE_DIR环境变量减少缓存路径长度。
Windows系统对文件路径长度默认限制为260个字符，当使用Composer安装PHP依赖时，深层嵌套的vendor目录很容易超出该限制，导致“File path too long”错误。这个问题在项目依赖较多或嵌套较深时尤为常见。解决方式主要围绕缩短路径和启用长路径支持展开。
启用Windows长路径支持
从Windows 10版本1607开始，系统支持超过260字符的路径，但默认未开启。需手动启用：
- 打开“组策略编辑器”（按 Win+R，输入 gpedit.msc）
- 导航到：计算机配置 → 管理模板 → 系统 → 文件系统
- 启用“启用Win32长路径”策略
若使用家庭版Windows无gpedit，可通过注册表修改：
- 打开注册表编辑器（regedit）
- 定位到
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem - 将
LongPathsEnabled值设为 1
将项目移到磁盘根目录
最直接的方式是缩短项目所在路径：
- 将项目移动到如
C:\project\或D:\p\等短路径下 - 避免嵌套在“文档”、“用户”等深层目录中（如 C:\Users\YourName\Documents\...）
例如，把项目放在 C:\v\ 目录，可大幅减少累积路径长度。
使用符号链接（Symbolic Link）
若无法移动整个项目，可将vendor目录重定向到短路径位置：
- 先删除原
vendor目录 - 运行命令创建符号链接：
mklink /J vendor C:\vnd\your-project - 再执行
composer install，依赖将实际安装到C:\vnd下
这样既保持项目结构不变，又规避了路径过长问题。
使用COMPOSER_CONFIG_DIR环境变量（辅助手段）
虽然不能直接解决vendor路径问题，但可设置Composer缓存到短路径，提升整体稳定性：
- 设置环境变量：
COMPOSER_CACHE_DIR=C:\c - 减少临时文件路径长度，间接降低出错概率
基本上就这些。优先启用系统长路径支持，再配合项目路径简化，大多数情况都能解决。符号链接适合复杂项目结构，灵活但需手动管理。问题不复杂，但容易忽略系统层面的设置。
