镜像源配置必须同时满足三个硬条件:repo.packagist不能多s、必须带composer type参数、url须为https且末尾带斜杠;否则配置不生效。

镜像源配置写对了没?三个硬条件缺一不可
执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 后仍慢,大概率是这一步根本没生效。它必须同时满足:
-
repo.packagist不能写成repos.packagist(多一个 s 就静默失败) - 中间必须带
composer这个 type 参数,漏掉就 fallback 到默认源 - URL 必须是 HTTPS + 末尾带斜杠:
https://mirrors.aliyun.com/composer/,少斜杠会 404 或回退
验证方式:运行 composer config -g repo.packagist,输出必须是完整 JSON 对象,形如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null 或仍是 https://packagist.org 都说明没写进去。
缓存不清,换源等于白换
旧缓存里存着 packages.json 和 provider 元数据,Composer 会优先读本地缓存再校验远程地址——哪怕你已经切了镜像,它仍反复尝试从 https://packagist.org 拉索引,卡在 DNS 解析或 TLS 握手阶段。
工作流任务拆解与模型编排技能。使用场景:(1) 收到复杂工作任务需要拆解为可执行步骤,(2) 需要为不同步骤选择最合适的模型,(3) 需要跟踪工作流进度和模型使用情况,(4) 长时间任务卡住需要问题诊断和解决方案。
- 必须执行
composer clear-cache(不是composer cache-clear,后者已废弃) - 验证是否清干净:检查
~/.composer/cache/repo/目录是否为空,或临时加--no-cache跑一次composer install -vvv,看日志里请求的是哪个域名 - 项目级
repositories字段会完全屏蔽全局配置,可用composer config --list和composer config --list --global对比确认实际生效的是哪个
parallel-downloads 设多少才真有用
这个参数只对 composer install 有效,不影响依赖解析,但它能显著压缩 ZIP 包下载时间。默认值 3 基本等于没开。
- 推荐设为 10:
composer config -g parallel-downloads 10 - 别盲目冲到 20:低配 CI 环境或企业内网可能出现
file_put_contents(): failed to open stream(临时文件竞争) - 该参数依赖镜像站支持 HTTP/2 多路复用,阿里云、中科大、清华镜像都支持;私有源不支持的话,设高了也白搭
- 运行
composer --version确认是 2.2+,1.x 版本需先composer self-update
Resolving dependencies 卡住跟镜像无关
这个阶段完全不走网络,是 Composer 在本地穷举满足所有约束的版本组合。尤其当你写了 "*"、"^1.0 || ^2.0" 或 "minimum-stability": "dev" 时,求解器会指数级爆炸。
- 收紧 PHP 版本声明:
"php": "^8.1"比">=7.4"少查几百个包的兼容性元数据 - 避免全量重算:确保
composer.lock已提交,不要删 lock 文件后跑composer install - 临时绕过求解器:
composer update --with-all-dependencies(CI 场景可用,不校验子依赖兼容性) - vendor 目录已存在但
composer update巨慢?可能是classmap-authoritative模式强制重扫整个 vendor 目录,关掉它:composer config authorative false










