直接执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 即可全局生效，但漏 -g、键名错为 repos.packagist、URL 末尾缺 / 或漏掉 composer type 值，四者任一出错均静默回退官方源；验证需 composer config -g repo.packagist 输出完整 JSON 对象。

直接执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 就能全局生效，但漏 -g、键名写成 repos.packagist、URL 缺末尾 / 或漏掉 composer 类型值，四者任一出错都会静默走官方源——不是慢，是根本没切过去。

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

Composer 2.x 硬编码只认 repo.packagist（单数、全小写、无 s），写成 repos.packagist 或 packagist.org 会存进无效字段，命令不报错，但查 composer config -g repo.packagist 输出为空或 null，install 仍卡在 Loading composer repositories...。

• -g 必须带上：漏了就只改当前项目 composer.json，换目录立即失效
• repo.packagist 是固定键名：大小写、复数、前缀缺一不可
• composer 是必需的 type 值：不是注释，省略就 fallback 到 https://packagist.org
• URL 必须以 https:// 开头且末尾带 /：少斜杠会拼成 /composerpackages.json，直接 404

一行命令切阿里云 / 腾讯云 / 华为云镜像

不同镜像路径格式差异明显，不能套用模板。华为云含 /repository/php/，中科大（USTC）同步略慢，清华旧镜像 https://packagist.phpcomposer.com 已下线，继续用会报 Could not resolve host。

Academic Composer Upload

辅助学术写作，包括查找资料、生成大纲、引用扩写及润色风格，同时确保引用规范。

下载

• 阿里云：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
• 腾讯云：composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/
• 华为云：composer config -g repo.packagist composer https://mirrors.huaweicloud.com/repository/php/composer/
• 中科大：composer config -g repo.packagist composer https://packagist.mirrors.ustc.edu.cn/

验证是否真在用镜像？别信“好像快了”

仅靠安装速度判断容易误判。必须交叉验证三处：

• 查配置：composer config -g repo.packagist 输出应为完整 JSON，如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
• 看诊断：composer diagnose 中 “Repo” 行必须显示镜像地址；若仍是 https://packagist.org，说明被项目级 repositories 覆盖
• 盯日志：删掉 vendor 和 composer.lock，运行 composer install -vvv，确认下载 URL 含 mirrors.aliyun.com 或对应镜像域名

项目级配置比全局更可靠？关键看场景

全局配置适合本地开发，但在 CI、宝塔面板、多用户环境里极易权限错位（比如 www 用户执行命令却写了 root 的全局配置）。项目级配置可 Git 跟踪，新人拉代码后行为一致。

• 进项目根目录，执行：composer config repo.packagist composer https://mirrors.aliyun.com/composer/（注意不加 -g）
• 它会安全合并到 composer.json 的 "repositories" 字段中，前提是原字段为对象（如 "repositories": { "packagist": {} }），不是数组
• 已有 "repositories": [] 或 "repositories": { "packagist.org": false } 时，需先手动清理再执行，否则旧缓存可能仍触发官方源请求

最常被忽略的是 composer.lock 里记录的 dist URL 仍指向原始源——哪怕镜像已生效，install 仍会先尝试旧地址。必须清缓存：composer clear-cache，必要时重生成 lock 文件。