Composer换国内镜像源需执行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，缺-g、键名错误、漏type值或URL缺斜杠均会静默失效；验证用composer config -g repo.packagist，输出JSON即生效；推荐阿里云源，项目级配置更适团队协作。
Composer 默认源在国外，国内直接用 composer install 经常卡在 Downloading... 或报 Connection timeout 错误——这不是你网络差，是源服务器响应慢或被干扰。换国内镜像能明显提速，但配置方式不对反而引发依赖解析失败或版本错乱。
怎么确认当前用的是哪个镜像源？
执行 composer config -g repo.packagist 查看全局镜像设置。如果输出为空，说明走的是官方源 https://packagist.org；如果返回类似 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}，就是已配置阿里云镜像。
注意：composer config -l 会同时显示全局（-g）和项目级配置，后者优先级更高，容易被忽略。
推荐三种安全配置方式（按优先级排序）
别直接改 composer.json 里的 repositories 字段——这会让所有协作者被迫同步你的镜像，且 CI 环境可能因权限或网络策略失效。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 全局配置（推荐）：运行
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/。阿里云镜像同步及时、稳定性好，适合大多数 PHP 项目。 - 临时切换（调试用）：加
--repository-url参数，例如composer update --repository-url=https://packagist.phpcomposer.com。适用于验证某个镜像是否可用，不持久化。 - 项目级配置（谨慎）：在项目根目录执行
composer config repo.packagist composer https://mirrors.huaweicloud.com/composer/。仅影响当前项目，但必须确保团队成员都执行过，否则依赖解析结果可能不一致。
镜像源选哪个？关键看同步延迟和 Composer 版本兼容性
不同镜像源的同步频率和对 Composer 2.x+ 的支持程度差异很大：
-
https://mirrors.aliyun.com/composer/：每 5 分钟同步一次，兼容 Composer 1.x 和 2.x，PHP 7.2+ 项目首选。 -
https://packagist.phpcomposer.com：已停止维护，部分包缺失或元数据陈旧，遇到Package not found错误时优先排除它。 -
https://mirrors.huaweicloud.com/composer/：华为云源，对国内教育网友好，但偶尔出现404 Not Found（尤其新发布的包），建议搭配composer clear-cache使用。
如果你的项目用了 composer require some/package:dev-main 这类开发分支依赖，务必确认镜像源是否同步了 dev 分支——阿里云和华为云通常只同步 stable 和 RC 标签，dev 分支需回退到官方源拉取。
配置完还是慢？先检查这几个地方
镜像生效 ≠ 一定快。常见瓶颈不在源本身：
- 本地
composer.lock文件里记录的是原始源的包哈希，换镜像后首次install仍要校验，耗时正常；后续执行才真正提速。 - 某些包（如
ext-*扩展）实际由 PECL 或系统包管理器安装，不受 Composer 镜像影响，卡住时看日志是否含pecl install或apt-get。 - 公司内网可能拦截 HTTPS 请求，尝试把镜像 URL 的
https改成http（仅限可信局域网），比如http://mirrors.aliyun.com/composer/。
最隐蔽的问题：CI 流水线里用了 Docker 缓存层，旧镜像配置被缓存住了，删掉 ~/.composer/cache 并重建镜像才能生效。
