换镜像后拉不到新包是因元数据同步延迟（5–30分钟），非配置错误；composer update默认复用本地缓存，--refresh仅在composer≥2.5时强制更新元数据，需确认全局镜像配置正确。
为什么换镜像后还是拉不到新发布的包
不是你配置错了，是镜像站元数据同步有延迟——哪怕阿里云、中科大这类主流镜像，实际同步间隔也在 5–30 分钟。Packagist 上刚发布的 v2.3.0，你本地 composer update 查不到，大概率是因为缓存的 packages.json 还没更新，而不是网络或命令问题。
-
composer update默认复用本地缓存（~/.composer/cache/repo/https---mirrors-aliyun-com-composer/）里的元数据，15 分钟内不过期 - 镜像站本身不托管 ZIP 包，只缓存 JSON 元数据；不同镜像节点同步节奏不同，跨国团队可能查到不同版本列表
- 若项目
composer.json里硬写了"repositories"，会覆盖全局配置，导致部分人走镜像、部分人 fallback 到官方源
composer update --refresh 真正起效的条件
composer update --refresh 只在 Composer ≥ 2.5 时有效，它强制丢弃所有已缓存的元数据文件（packages.json、provider-*.json），重新从当前配置的镜像源下载最新版本列表——但不重下 ZIP 包，也不清 dist 缓存。
- 执行前先确认镜像地址：运行
composer config -g repo.packagist，输出必须是你想用的地址，比如https://mirrors.aliyun.com/composer/ - 如果输出是
https://packagist.org或空，--refresh会去官方源拉，而非你预期的镜像 - 老版本 Composer（≤ 2.4）不支持该参数，只能手动删缓存目录：
rm -rf $(composer config --global cache-dir)/repo/https---mirrors-aliyun-com-composer
哪些镜像站同步最快且稳定（2026 年实测）
截至 2026 年 6 月，真正能做到“同步快 + 全量 + HTTPS + Composer 2.x 原生支持”的镜像只剩三个，且适用场景不同：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
https://mirrors.aliyun.com/composer/：同步最快（多数新包 5 分钟内入库），CDN 覆盖全，适合日常开发和 CI 构建；阿里云 ECS 用户可改用内网地址http://mirrors.cloud.aliyuncs.com/composer/（仅限 VPC 内） -
https://packagist.mirrors.ustc.edu.cn/：中科大镜像，北方及教育网访问延迟低，新包响应及时，稳定性优于清华源 -
https://packagist.mirrors.sjtug.sjtu.edu.cn/：上海交大 SJTUG 镜像，学术机构运维，无商业干扰，适合对一致性要求高于速度的生产环境
注意：https://packagist.phpcomposer.com 已停更多年，配置后会导致 404 Not Found；https://packagist.jp 和 https://packagist.com 是商业服务，非免费镜像，国内访问反而更慢。
CI/CD 中避免构建漂移的关键动作
GitHub Actions、GitLab CI 每次都是干净环境，不会继承你本地的镜像配置。如果只写 composer install，它默认回退到官方源，而你的 composer.lock 是在阿里云镜像下生成的——元数据不一致时，Composer 会重新解析依赖图，结果可能升级或降级版本。
- Docker 构建阶段加一句：
RUN composer config -g repo.packagist composer https://packagist.org（推荐用于跨国项目）或https://mirrors.aliyun.com/composer/（国内项目） - GitHub Actions 缓存
~/.composer前，先运行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/写入配置 - 不要在
composer.json里写死"repositories"，尤其不要引用已失效的旧镜像 URL，否则composer install会静默 fallback，行为不可控
同步延迟无法彻底消除，但能被精准控制——关键不是“选最快的镜像”，而是让所有人、所有环境明确知道该连谁、什么时候该刷新元数据。
