提升开发幸福感的Composer镜像配置-composer-PHP中文网

composer config -g repo.packagist 总不生效是因为三个硬性条件缺一不可：键名必须为单数 repo.packagist、type 值必须显式写 composer、URL 必须 HTTPS 且末尾带 /；任一出错即静默回退官方源，验证需输出完整 JSON 对象。

提升开发幸福感的composer镜像配置

composer config -g repo.packagist 为什么总不生效

它不报错，但就是不走镜像——这是最折磨人的地方。根本不是网络问题，而是三个硬条件漏一个就静默 fallback 到 https://packagist.org：

repo.packagist 键名必须严格为单数、全小写；写成 repos.packagist 或 repositories.packagist，命令执行成功，但 Composer 完全忽略
中间那个 composer 是 type 值，不是可选参数；漏掉就等同于没配，尤其在旧版 Composer 中更隐蔽
URL 必须是 HTTPS + 末尾带斜杠：https://mirrors.aliyun.com/composer/ ✅，https://mirrors.aliyun.com/composer ❌（少斜杠会导致路径拼接错误，返回 404 后仍 fallback）

验证是否真写进去了？只看这一行输出：composer config -g repo.packagist。正确结果要么是完整 JSON：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}，要么是纯 URL 字符串。空、null、或仍是 https://packagist.org，说明根本没写进去。

项目级配置怎么避免覆盖私有源

进项目根目录后运行 composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加 -g），这条命令的行为取决于你当前 composer.json 的 repositories 字段格式：

如果原先是 "repositories": {}（空对象），命令会自动插入 "packagist": {"type": "composer", "url": "..."} ，不破坏结构
如果原先是 "repositories": []（空数组），命令会报错；需先手动改成 {} 再执行
如果已有私有 VCS 源（如 Git 地址），命令会向数组末尾追加，但前提是 repositories 是数组格式；若为对象格式，则会转为标准数组并保留原有 key

改完必须删掉 vendor/ 和 composer.lock：因为 lock 文件里记录的是旧源下的 dist URL，不删它，composer install 仍按旧地址下载，根本不会走新镜像。

宝塔、CI、Docker 里镜像为啥不生效

全局配置 -g 是按用户隔离的，不是系统级。你在终端用 root 配了，但宝塔用 www 用户跑命令，它就读不到。

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

查实际执行用户：sudo -u www composer config -g repo.packagist，如果为空，说明该用户没配
正确做法：用对应用户重配，例如 sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
CI 脚本或 Docker 构建中，别依赖全局配置；改用临时参数更可靠：composer install --repository-url=https://mirrors.aliyun.com/composer/

注意：composer create-project 默认忽略全局镜像，它优先读取模板项目自带的 composer.json 中的 repositories 字段。想强制走镜像，只能加 --repository-url 参数。