超详细的Composer国内镜像源配置指南-composer-PHP中文网

composer config -g repo.packagist 总不生效是因为必须同时满足三个硬性条件：键名严格为单数 repo.packagist、type 值显式写 composer、URL 须 HTTPS 且末尾带 /；任一不符即静默回退官方源，且不报错。

超详细的composer国内镜像源配置指南

直接执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 就能生效，但 90% 的失败都卡在这条命令的三个硬性条件上——写错一个就静默回退官方源，不报错也不提示。

为什么 `composer config -g repo.packagist` 总是没反应

不是网络问题，也不是权限不够，而是 Composer 2.x 对配置结构极其严格：它只认 repo.packagist 这个固定键名（注意是 repo 单数，不是 repos），且必须显式声明 type 值为 composer，URL 还得是 HTTPS + 末尾带 /。

repos.packagist（多一个 s）→ 写入无效字段，composer config -g repo.packagist 返回空或报错
composer config -g repo.packagist https://mirrors.aliyun.com/composer/（漏掉 composer）→ 静默 fallback 到官方源
https://mirrors.aliyun.com/composer（少斜杠）→ 请求会拼成 /composerpackages.json，404

验证是否真写进去了：运行 composer config -g repo.packagist，输出必须是完整 JSON，比如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。返回空、null、Key not found 或只有一行 URL 字符串，都说明失败。

项目级配置怎么安全追加而不炸掉私有仓库

项目已有 "repositories": {} 或 "repositories": [] 时，手动编辑 composer.json 极易出错——引号不全、方括号不配对、误删已有源，都会导致 composer install 直接报错。

进项目根目录，执行 composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉 -g）
如果原 repositories 是空对象 {}，命令会自动转为标准格式并追加 "packagist" 子项
如果原 repositories 是数组 []，命令会报错；需先手动改成 {} 再重试
千万别写 "packagist.org": false——这会禁用基础包校验，php、ext-json 等依赖直接无法安装

改完后务必运行 composer update --lock，确保 composer.lock 记录的是新镜像地址，否则协作者拉代码仍走旧源。

Workflow Decomposer

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

下载

宝塔、CI、Docker 里全局配置为啥不起作用

全局配置写在 ~/.composer/config.json，但它只对当前 shell 用户生效。宝塔后台、计划任务、GitHub Actions 默认以 www、runner 或容器内非 root 用户运行，根本读不到你的配置。

查实际执行用户：whoami 或看日志里的 UID
给 www 用户配镜像：sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
GitHub Actions 中不能依赖全局配置，需在 workflow 里显式设置：COMPOSER_HOME: /tmp/composer，再用 composer config 写入
Docker 构建时，~/.composer 不存在，必须在 Dockerfile 里用 RUN composer config -g ... 并确保用户一致

换源后还卡在 Loading composer repositories？大概率是缓存或 composer.lock 里还存着旧地址。先 composer clear-cache，再删掉 vendor/ 和 composer.lock，最后 composer install -vvv 观察请求是否发往 mirrors.aliyun.com。

换源后 `composer update` 还卡在 Resolving dependencies

镜像只加速元数据下载和包文件拉取，不解决依赖解析慢的问题。这个阶段卡住，和镜像源完全无关。

检查 composer.json 是否写了过于宽泛的版本约束，比如 "^1.0 || ^2.0" 或 "dev-main"，会导致 Composer 尝试大量组合
确认没启用 minimum-stability: dev，否则会拉取所有不稳定分支进行比对
某些插件（如 hirak/prestissimo）在新版 Composer 中已废弃，反而拖慢解析速度，建议卸载

真正容易被忽略的点是：镜像同步有 5–30 分钟延迟，刚发布的包可能还没收录。遇到 Could not find package xxx，先打开 https://mirrors.aliyun.com/composer/packagist/ 搜一下，别急着换源或重装。