适合新手的全局Composer镜像源配置教学-composer-PHP中文网

composer全局镜像配置生效需同时满足三个硬性条件：repo.packagist必须单数且带前缀、第二个参数必须为composer、url须https开头并以斜杠结尾；缺一即静默回退原站。

适合新手的全局composer镜像源配置教学

直接配 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 就能用，但 90% 的新手卡在这条命令根本没生效——不是网络慢，是三个硬性条件漏了一个，Composer 就静默回退到 https://packagist.org，连 warning 都不报。

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

这条命令看似简单，实则对格式零容忍。漏掉任意一个，配置就等于没写进去，composer install 依然卡在 “Loading composer repositories”。

repo.packagist 必须是单数、带 repo. 前缀——写成 repos.packagist、packagist.org 或 Repo.Packagist 全部无效
第二个参数 composer 是 type 值，不是注释，不能省略，也不能替换成 https 或其他字符串
URL 必须是 HTTPS 开头，且末尾必须带斜杠：https://mirrors.aliyun.com/composer/ ✅，少斜杠会拼出 /composerpackages.json 导致 404
必须加 -g，否则只改当前项目下的 composer.json，换目录或新开终端就失效

怎么验证镜像真的写进去了

别信终端显示 “OK”，要靠输出确认。真正有效的判断依据只有一条：

运行 composer config -g repo.packagist，输出必须是完整 JSON 对象，例如：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
如果返回空、null、Key not found，或者只有一行 https://packagist.org，说明配置失败，立刻重试
Windows 用户改完需重启终端；Linux/macOS 用户若设过 COMPOSER_HOME 环境变量，要确认它指向的是你预期的路径

全局配置在宝塔、GitHub Actions 里常失效

全局配置写在 ~/.composer/config.json，但它只对当前 shell 用户生效。而真实环境中：

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

宝塔默认用 www 用户执行命令，你配的是自己的用户，它读不到
GitHub Actions 默认用 runner 用户，-g 配的是该用户的 home 目录，不是 root
Docker 容器内若未指定用户，可能以 root 运行，但你配的是宿主机普通用户

更稳妥的做法是项目级配置：进项目根目录（含 composer.json），运行 composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉 -g）。它会自动写入 composer.json 的 repositories 字段，提交后团队和 CI 都能一致行为。

换源后仍卡住？清缓存和删文件是硬性步骤

镜像只加速元数据拉取和 ZIP 下载，但 Composer 会优先读本地缓存和 composer.lock 里的旧地址。哪怕你刚配好镜像，它也可能还在往 packagist.org 发请求。

先清缓存：composer clear-cache
再删掉 vendor/ 和 composer.lock
最后执行 composer install（不是 update）
想确认是否真走镜像？跑 composer install -vvv，滚动日志找 https---mirrors-aliyun-com-composer 这类路径