刚 clone 项目就报错，90% 是漏掉 composer.lock 文件、vendor 目录误提交或 .gitignore 配置错误，以及 composer.json 中包名拼写或 platform 版本与本地 PHP 环境不匹配所致。
刚 clone 项目就报错，先确认这三件事
不是网络慢、不是镜像挂了，90% 是项目交付前漏掉了关键文件或配置。直接看报错关键词，比盲目换源更省时间。
-
composer.lock文件必须存在且已提交到 Git —— 如果它被 .gitignore 错误排除，composer install会 fallback 到composer update行为，结果不可控 - 检查
vendor/是否被意外提交进仓库（不该进），或被.gitignore漏掉（该进但没进）—— CI 拉不到完整代码树时，autoload.php生成失败是常见连锁反应 - 打开
composer.json，逐行核对包名拼写：比如"laravel/framework": "10.x-dev "尾部多一个空格，install阶段不报错，但后续php artisan执行时类找不到
报 “Your requirements could not be resolved” 不是依赖冲突，是环境不匹配
这个错误常被误读为“版本打架”，实际是本地 PHP 环境无法满足 composer.lock 中已锁定包的运行前提。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 运行
php -v，再执行composer show php—— 两者输出必须一致；若你本地是 PHP 8.0，而锁文件里某包要求php >= 8.1，就会卡在这里 - 检查是否启用了必要扩展：
php -m | grep -E "(openssl|zip|mbstring|curl)"，缺任何一个都可能导致install中断或 autoload 失效 - 留意
composer.json顶部"config": {"platform": {}}字段 —— 它硬编码了平台版本（如"php": "8.2.10"），但你本地是 PHP 8.2.5，Composer 默认拒绝安装
报 “CreateProcess failed” 或 “The system cannot execute the specified program”
这是 Windows 上 PATH 超长的典型症状，不是 Composer 坏了，而是系统限制触发了进程创建失败。
- 用 PowerShell 快速验证：
echo %PATH% | powershell -Command "$input.Length"—— 若结果 > 32767，就是它了 - 重点清理重复的 Composer bin 目录：运行
composer config --global bin-dir查出路径（通常是%APPDATA%\Composer\vendor\bin），然后在「系统属性 → 环境变量」中彻底删除所有指向它的条目（用户级 + 系统级） - 禁用自动 PATH 注入：旧版 Composer-Setup.exe 或某些 IDE 插件会在注册表
HKEY_CURRENT_USER\Environment\PATH里偷偷写入，手动删掉；后续改用composer exec laravel new myapp替代全局 PATH 调用
报 “Allowed memory size exhausted” 或卡在 loading repositories
内存不足和网络卡顿经常被混为一谈，但处理方式完全不同 —— 前者要调内存，后者要切源+清缓存。
- 临时解决内存问题：直接加参数
composer install --memory-limit=2G，比改php.ini更快，也避免影响其他 CLI 工具 - 网络卡顿别信
composer.json里的repositories—— 它优先级低于全局配置，先运行composer config -g repo.packagist确认实际生效的是哪个源；阿里云地址必须是https://mirrors.aliyun.com/composer/（末尾斜杠不能少） - 换源后必须清缓存：
composer clear-cache，否则失败记录还在，重试照样走原地址
composer install 不代表能跑起来。autoload 映射没生效、vendor/bin 下命令找不到、甚至 php -d display_errors=1 artisan tinker 报类不存在——这些问题几乎都源于 composer.json 里 autoload 和 autoload-dev 的路径配置与实际目录结构不一致，而不是重装就能解决。 
