Windows下composer install报“路径太长”错误，需启用系统长路径支持、关闭classmap-authoritative模式，并清理旧autoload缓存文件。
Windows下composer install报“路径太长”错误怎么办
直接结论：不是Composer本身的问题，是Windows默认禁用长路径导致的。关键在系统级开关+少量配置调整，不是删包或换工具。
常见错误现象：The filename or extension is too long、failed to open dir: No such file or directory（实际目录存在），尤其出现在vendor/composer/autoload_classmap.php或深度嵌套的测试文件路径中。
- 必须启用Windows长路径支持：打开
组策略编辑器→ 计算机配置 → 管理模板 → 系统 → 文件系统 → 启用“Win32长路径”，设为已启用；若用家庭版，改注册表HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem@LongPathsEnabled为1 - 重启命令行终端（CMD/PowerShell/Git Bash）——不重启无效，因为进程继承旧环境
- 确认PHP本身没硬编码限制：检查
php.ini里open_basedir是否误锁了vendor父目录
为什么composer config vendor-dir不能彻底解决路径问题
把vendor挪到D:\v这种短路径，看似治本，实则只缓解表层——Composer生成的自动加载文件（如autoload_static.php）仍会拼出超长绝对路径，且部分包的tests/或src/内嵌套过深，移目录不解决根本。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
-
composer config vendor-dir "D:/v"确实缩短了顶层路径，但Composer 2.2+默认开启class-map-authoritative，会扫描全路径生成映射，深度嵌套类名仍触发系统限制 - 某些包（如
phpunit/phpunit）自带大量tests/_files/very/deep/nested/structure/，即使vendor在D盘，完整路径也可能突破260字符 - 真正有效的是关掉冗余扫描：
composer config -g allow-plugins.composer/installers false（非必需），更关键是后续关闭classmap权威模式
关掉classmap-authoritative能绕过路径限制吗
能，而且推荐关——它本就不是日常开发必需项，反而在Windows上成主要雷区。
- 该选项让Composer跳过运行时文件存在性检查，全靠预生成的classmap加载，但生成过程需遍历所有PHP文件，路径一深就崩
- 执行
composer config classmap-authoritative false（项目级）或composer config -g classmap-authoritative false（全局），再composer dump-autoload - 性能影响极小：现代PHP有OPcache，autoload性能差异几乎不可测；开发阶段完全不需要这个优化
- 注意：Laravel等框架默认启用，检查
composer.json里是否含"optimize-autoloader": true，CI流程中才需保留，本地开发建议删掉
Git Bash或WSL环境下仍报错？检查你的shell路径解析逻辑
很多人切到Git Bash以为万事大吉，结果照样挂——因为Git Bash默认用MSYS2路径转换，把/d/v/vendor/...又转回D:\v\vendor\...\，照样超长。
- 临时解决：启动Git Bash时加参数
winpty bash，或在~/.bashrc里加export MSYS_NO_PATHCONV=1（禁用自动路径转换） - 更稳方案：直接用Windows原生PowerShell（非x86版），确保
$PSVersionTable.PSVersion.Major -ge 6，再运行composer - WSL用户注意：不要在
/mnt/c/...下操作Windows项目，把代码放/home/xxx/project里，用WSL PHP跑composer——此时路径长度由Linux内核管，无260限制
最易被忽略的一点：就算开了长路径、关了classmap权威、换了shell，如果PHP扩展（如opcache）缓存了旧的autoload文件，依然可能复现错误。遇到反复报错，先删vendor/composer/autoload_*.php和bootstrap/cache/*.php，再重装。
