答案是键名必须为repo.packagist、type值必须显式填composer、url须以https://开头且末尾带/，三者缺一不可；任一错误均静默回退至官方源，且项目级repositories字段会完全屏蔽该配置。
为什么composer update还是走官方源？检查这三处硬伤
配了镜像却没生效，90% 是命令写错三个关键点：键名必须是 repo.packagist（不是 repos.packagist），type 值必须显式写 composer，URL 必须用 HTTPS 且末尾带 /。漏掉任意一个，Composer 都静默 fallback 到 https://packagist.org，不报错也不提示。
验证是否真生效，别看命令有没有报错，直接运行：
composer config -g repo.packagist
输出必须是完整 JSON，例如：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。如果返回 null、空行或报错，说明根本没写进去。
- Windows 用户改完要重启终端，否则环境变量未刷新
- 用
sudo composer config -g写进了 root 配置，但 PHP 进程以普通用户跑，照样不生效 - 项目根目录已有
"repositories"字段，会完全屏蔽全局配置，此时得查composer config repo.packagist（不带-g）
composer update --refresh 是最轻量的元数据同步方式
镜像站同步是服务端行为，客户端无法“触发源站立刻更新”。你能控制的只有本地如何重新获取最新索引——composer update --refresh（Composer ≥ 2.5）就是为此设计的：它丢弃所有缓存的 packages.json 和 provider-*.json，强制从当前配置的镜像源重拉元数据，但保留已下载的 ZIP 包，不重复下载。
注意：composer clear-cache 几乎无效，它只删 ZIP 和部分 provider 缓存，对决定“包是否存在”的核心元数据文件不起作用。
- 执行前先确认镜像地址正确：
composer config -g repo.packagist - 加
--no-cache -v可看到终端真实发出的请求 URL，确认是否命中你配的镜像 - 老版本（rm -rf $(composer config --global cache-dir)/repo/https---mirrors-aliyun-com-composer
阿里云 vs 腾讯云 vs 华为云：个人开发怎么选
三家主流镜像同步延迟都在 5–15 分钟，差别不在“快慢”，而在稳定性与兼容性适配：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（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/）：华北节点响应快，日常开发够用；但华东偶发 502，CI 构建高频依赖更新时可能卡住 - 腾讯云（
https://mirrors.cloud.tencent.com/composer/）：CDN 覆盖广，南方用户连接稳定；缺点是不保留已下架包，遇到Package not found要先确认是否原包被作者删除 - 华为云（
https://mirrors.huaweicloud.com/repository/php/）：全量历史包，适合需要回滚旧版本的场景；metadata 请求略慢，但安装成功率高
测试方法很简单：清缓存后跑 time composer update --dry-run，重点看是否出现 Connection refused 或 SSL certificate problem——后者多因镜像用了过期中间证书。
临时换源比全局配置更适合个人调试
个人开发常需快速验证某个包在不同镜像下的表现，或临时绕过本地污染配置。这时用 --repository-url 比改全局更干净：
composer install --repository-url=https://mirrors.aliyun.com/composer/
注意：--repository-url 只影响元数据拉取（即 packages.json 列表），实际 ZIP 包仍可能走原始 dist URL。更稳妥的方式是配合环境变量：
COMPOSER_REPO_PACKAGIST=https://mirrors.aliyun.com/composer/ composer install --prefer-dist
这样能确保 dist 包也走镜像代理（阿里云镜像支持完整代理）。
- 私有 GitLab 包未在镜像中同步时，此方式会失败，需单独在
repositories中追加 VCS 源 - Docker 构建或 CI 环境中，推荐用环境变量方式，避免污染构建机配置
- 别在
composer.json里手写"repositories"对象，要用数组格式并首项写{"packagist.org": false}，否则 Composer 2.2+ 会忽略
真正容易被忽略的是：镜像只解决元数据和 ZIP 下载问题，Resolving dependencies 卡住几十秒，和镜像完全无关——那是 PHP 版本约束太松、require-dev 工具链太多、或 lock 文件平台不一致导致的解析爆炸。这时候换十个镜像也没用。
