必须启用windows长路径支持并重启，再配合短路径项目位置、精简vendor-dir、禁用符号链接等措施，才能彻底解决composer的file path too long问题。
Windows 下 Composer 报 File path too long 或 mkdir(): Invalid argument，不是配置没写对，是系统级 MAX_PATH 限制没打开——其他所有操作（改 vendor-dir、删空格、缩路径）都只是缓解，不打开长路径支持，迟早还会崩。
必须先启用 Windows 长路径支持
这是硬性前提，跳过这步，后面全白忙。Windows 10 v1607+ 支持长路径，但默认关闭：
- 专业/企业版：按
Win+R输入gpedit.msc→ 计算机配置 → 管理模板 → 系统 → 文件系统 → 启用 Win32 长路径 → 设为“已启用” - 家庭版：按
Win+R输入regedit→ 定位到HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem→ 将LongPathsEnabled的 DWORD 值设为1 - 改完必须重启电脑——只重启终端、IDE 或 PHP 进程无效
项目路径本身要足够短
路径长度是累计值：C:\ + 你的项目路径 + vendor 内部嵌套深度。一个 C:\Users\Alice\Documents\GitHub\my-laravel-app\vendor\... 开头就占掉 60+ 字符，留给依赖嵌套的空间极小。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 把项目挪到根目录下的单字母子目录，比如
C:\p\myapp或D:\proj，直接省掉上百字符 - 路径中避免空格、中文、特殊符号；尤其别放在
OneDrive、Dropbox同步文件夹里——它们会在路径前加隐藏代理层，进一步挤压可用长度 - 不要信“放桌面也行”，
C:\Users\Alice\Desktop\已经很长了
控制 vendor 目录位置和命名
composer.json 里的 config 段能起作用，但得写对地方、配合物理路径调整：
- 缩短目录名：
"vendor-dir": "v"比默认vendor少 5 字符，积少成多 - 移到短路径：
"vendor-dir": "C:/v"（注意斜杠方向），再用mklink /D C:\v D:\long\path\to\project\v建符号链接，逻辑路径短、物理路径清晰 - 禁用符号链接：
"symlink": false，尤其在 NTFS 权限受限或某些 CI 环境下，软链反而引发权限或解析问题
长期开发建议直接用 WSL
在 WSL（如 Ubuntu）中运行 Composer，完全绕过 Windows 的 MAX_PATH 限制，也不用折腾注册表或符号链接：
- 安装 WSL2（推荐 Ubuntu 22.04+）
- 把项目放在 Linux 子系统路径下，例如
/home/user/project - 所有
composer install、update都在 WSL 终端执行，不再触发File path too long - 注意：不要把项目放在 Windows 挂载点（如
/mnt/c/...）下，否则仍走 Windows 文件系统，限制照旧
最易被忽略的点是：很多人开了长路径支持却没重启，或者以为改了 vendor-dir 就一劳永逸，结果深层嵌套的包（比如 Symfony 多层 Adapter/Proxy/Registry）依然超限。路径优化是组合拳，缺一不可。
