composer install报错八成因镜像未生效、缓存未清、权限污染或php环境不匹配，需检查repo.packagist键名、composer type值、https带斜杠url三条件，验证输出为完整json，再排查dns、tls、ca证书及权限归属问题。
composer install 报错，八成不是命令写错了，而是它根本没按你想的路径走——镜像没生效、缓存没清、权限被污染、PHP 环境不匹配，它就安静 fallback 到 packagist.org，然后卡住、超时、报错，还不告诉你原因。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
镜像配置对了但没生效？检查这三处硬性条件
composer config -g repo.packagist 看起来成功，不代表真在用。必须同时满足：
- 键名只能是
repo.packagist（不能是repos.packagist或repositories.packagist） - type 值必须显式传入
composer（漏掉这个，Composer 2.x 直接忽略整条配置） - URL 必须是 HTTPS 且末尾带
/（https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌）
composer config -g repo.packagist，输出必须是完整 JSON 对象，比如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。如果还是 https://packagist.org，说明没写进去。
换源后还是卡在 “Loading composer repositories”？别只盯镜像
镜像只加速元数据和 ZIP 包拉取，不解决底层连通问题：- DNS 解析失败：运行
ping packagist.org，返回unknown host就得换 DNS（比如设为8.8.8.8） - TLS 握手卡住：运行
curl -v https://mirrors.aliyun.com/composer/，看停在* Connected to还是* TLS handshake；若卡在后者，加环境变量COMPOSER_IPV4=1强制走 IPv4 - CA 证书过期：PHP 的
openssl.cafile或curl.cainfo指向了旧证书文件（如停更于 2021 年的curl-ca-bundle.crt），需下载最新cacert.pem并在php.ini中统一设置
报 “Permission denied” 写 vendor/ 或 composer.lock？大概率是归属权错了
不是缺权限，是目录“认错了主人”：- 错误现象：报错里带具体路径，比如
file_put_contents(/path/to/vendor/autoload.php): Permission denied - 立刻检查归属：
ls -ld vendor/ composer.lock $(composer config -g home)，如果属主是root，而你当前是普通用户，就会失败 - 修复方式：
sudo chown -R $USER:$USER vendor/ composer.lock ~/.composer（Linux/macOS）；Windows 下重点查杀毒软件是否拦截 .bat 文件生成 - 别用
chmod 777硬怼——治标不治本，还埋安全坑
报 “Your requirements could not be resolved”？不是依赖冲突，是环境不达标
composer install 是按 composer.lock 精确还原，不是解依赖：
- PHP 版本低于锁文件中某包要求（比如锁了
monolog/monolog v3.5.0，它要求 PHP >=8.1，而你本地是 8.0） - 扩展缺失：
ext-mbstring、ext-xml、ext-curl、ext-zip任一未启用，composer diagnose会直接标出 -
composer.json里写了"config": {"platform": {"php": "8.2.10"}}，但实际环境是 PHP 8.1 —— 这个配置会强制覆盖真实版本判断 -
--ignore-platform-reqs只能临时绕过，装出来的包大概率运行时报错，不是解决方案
最常被忽略的一点：composer install 成功，不代表项目能跑。vendor/autoload.php 没加载、类找不到、artisan 命令不存在，90% 是因为自动加载映射没生效或路径引用错位——别急着重装，先确认 vendor/autoload.php 存在且可读，再检查入口文件里 require 的路径是否正确。
