启用Windows长路径并调整Composer目录位置可解决文件路径过长问题。首先通过组策略或注册表将LongPathsEnabled设为1，启用系统级长路径支持；然后以管理员身份运行命令提示符执行composer install；接着将Composer缓存和数据目录配置到短路径如C:\c\cache，并设置vendor-dir为C:\lib\vendor；还可使用mklink将vendor映射到短路径；同时保持PHP和Composer版本更新，并将项目放在靠近根目录的路径下开发，避免深层嵌套，从而有效避免“File name too long”错误。
Windows系统对文件路径长度默认限制为260个字符，当使用Composer安装PHP依赖时，深层嵌套的vendor目录很容易超出该限制，导致“File name too long”或“symlink failed”等错误。这个问题在Windows 7/8/10中尤为常见。以下是几种有效解决方法：
启用Windows长路径支持（推荐）
从Windows 10 周年更新（版本1607）开始，可通过组策略或注册表启用长路径支持。
操作步骤：
- 按 Win + R，输入
gpedit.msc打开本地组策略编辑器（家庭版系统可能无此工具） - 导航到：计算机配置 → 管理模板 → 系统 → 文件系统
- 双击“启用Win32长路径”，选择“已启用”，点击确定
或者通过注册表修改：
- 运行
regedit - 定位到
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem - 将
LongPathsEnabled的值设为1（如不存在则新建 DWORD 32位）
以管理员身份运行命令提示符
某些操作（如创建符号链接）需要管理员权限。即使启用了长路径，权限不足仍会导致失败。
右键“命令提示符”或“终端”，选择“以管理员身份运行”，再执行：
composer install
更改 Composer 全局目录位置
将 vendor 或缓存目录移到路径较短的目录下，例如根目录下的一个短路径文件夹。
设置全局缓存和数据目录：
composer config --global cache-dir "C:\c\cache" composer config --global data-dir "C:\c\data"
或在项目中指定 vendor 目录：
composer config vendor-dir "C:\lib\vendor" composer install
使用 NTFS 符号链接缩短路径（进阶）
将项目依赖目录映射到短路径位置：
mklink /D C:\v D:\your\very\long\project\path\vendor
"config": {
"vendor-dir": "C:/v"
}
升级 PHP 和 Composer 版本
确保使用最新版 Composer（2.x）和 PHP（8.0+），它们对 Windows 长路径的支持更完善。
更新命令：
composer self-update
避免深层嵌套项目结构
尽量将项目放在短路径下开发，例如：
C:\www\myproject
而不是：
C:\Users\YourName\Documents\Projects\Company\Client\Year\Project\...
基本上就这些。启用长路径 + 使用短目录路径是最稳定组合。多数情况下，只需开启系统长路径并把项目放得离根目录近一点，就能彻底解决问题。
