应执行 composer config -g repo.packagist 查看全局配置，但仅返回非空 JSON 不代表生效；必须结合 composer diagnose 的“Repo:”行、composer show -p 首行域名及 -vvv 日志中 Downloading 请求 URL 三处验证，且需确保键名正确、type 为 composer、URL 以 https:// 开头并以 / 结尾，并执行 composer clear-cache。
确认当前生效的镜像源，别只信 composer config -g repo.packagist 输出
执行 composer config -g repo.packagist 返回非空 JSON（如 {"type":"composer","url":"https://mirrors.aliyun.com/composer/"}）只是第一步。它只说明全局配置写进去了，但不等于实际生效——项目根目录下 composer.json 里的 repositories 字段会无条件覆盖它，且完全不报错。
真正验证是否走镜像，得看三处：
-
composer diagnose输出中 “Repo:” 行显示的域名必须匹配你设的镜像地址 -
composer show -p | head -3第一行应含mirrors.aliyun.com这类镜像域名 - 加
-vvv运行composer update，日志里所有Downloading请求 URL 必须带镜像路径，不是packagist.org
composer config -g repo.packagist 不生效的四个硬性条件
这条命令看似简单，但缺一不可：
- 键名必须是
repo.packagist（单数，不是repos.packagist或repositories.packagist.org；后者在 Composer 2.9.6 中会被静默忽略） - 第三个参数必须是
composer，表示类型，漏掉就 fallback 到官方源 - URL 必须以
https://开头、且以/结尾：https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（会拼出 404 路径） - 执行后必须立刻运行
composer clear-cache，否则旧元数据仍缓存在本地，请求照发往 packagist.org
阿里云镜像是目前唯一全量同步、HTTPS 可靠、持续维护的选项
截至 2026 年 7 月，其他镜像已明显掉队：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
https://packagist.laravel-china.org和https://packagist.phpcomposer.com已停止维护，composer update直接返回 404 或 cURL error 60 - 清华源
https://mirrors.tuna.tsinghua.edu.cn/composer/对教育网友好，但南方用户偶发 DNS 解析慢；新包同步常滞后 10–15 分钟 - 腾讯云公网镜像
https://mirrors.cloud.tencent.com/composer/偶发 502，VPC 内推荐用内网地址http://mirrors.tencentyun.com/composer/（仅限腾讯云服务器） - 中科大、SJTUG 镜像适合 CI/CD 流水线等重稳定性轻速度的场景，但需确认出口 IP 在白名单内，否则可能 403
阿里云镜像 https://mirrors.aliyun.com/composer/ 同步延迟稳定在 1–3 分钟，Laravel 11、PHP 8.4 兼容包当天入库，CDN 覆盖全国，且支持 VPC 内网加速地址 http://mirrors.cloud.aliyuncs.com/composer/（仅限阿里云 ECS）。
项目级配置比全局更可靠，但要注意 "packagist.org": false
团队协作或 CI 环境下，全局配置无法被 Git 跟踪，容易导致 composer.lock hash 不一致。推荐进项目根目录执行：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/
该命令会自动向 composer.json 的 repositories 字段追加一条 "packagist" 条目，不破坏已有私有源。但注意：如果项目里已有 repositories，必须显式加上 "packagist.org": false，否则 Composer 仍可能回退到官方源触发超时。
换源后首次安装，建议删掉 composer.lock 和 vendor/ 重来，避免旧锁文件残留官方源引用。
