全局切换阿里云镜像只需执行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/,该命令写入~/.composer/config.json并覆盖旧配置,后续所有composer install或require均生效;切完应运行composer clear-cache清除旧元数据缓存。

Composer 默认走国外源,国内直连经常超时、卡死或下载极慢。直接切阿里云或腾讯云镜像,能解决 90% 的包安装失败问题。
如何全局切换到阿里云镜像
执行一条命令即可覆盖全局配置,后续所有 composer install 或 composer require 都会走阿里云源:
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
注意:-g 表示全局,不加则只影响当前项目;如果之前设过其他镜像(比如华为云),这条命令会覆盖它。
- 该配置写入
~/.composer/config.json,可手动检查确认 - 若提示
Could not fetch且 URL 是 packagist.org,说明没生效,多因权限或缓存导致 - 切完建议运行
composer clear-cache清掉旧源的元数据缓存
临时换源:单次命令指定镜像
不想改全局配置?用 -vvv 加 --repository-url 可临时指定源,适合调试或 CI 场景:
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论(Discussion)”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性,以及撰写结论。当用户输入以下任一指令时也会自动触发该功能: - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
composer require monolog/monolog --repository-url=https://mirrors.tencent.com/composer/ -vvv
-vvv 能看到真实请求地址,确认是否走对了镜像;腾讯云和阿里云镜像内容一致,但域名不同,部分网络环境下腾讯源更稳。
- 临时参数优先级高于全局配置,无需担心污染环境
- CI 脚本中推荐用这种方式,避免依赖宿主机的全局设置
- 注意 URL 末尾不要带斜杠,否则某些版本 Composer 会拼出双斜杠导致 404
为什么 composer create-project 还是慢
这个命令默认会先拉 composer.json 再递归安装依赖,但第一步获取项目模板时并不走 packagist 镜像 —— 它直连 GitHub/GitLab,和源配置无关。
- 如果你卡在
Cloning XXX,不是镜像问题,是 Git 协议被限速,可改用 HTTPS 并配 Git 代理 - 想跳过 Git 克隆,改用 ZIP 包方式:
composer create-project laravel/laravel --prefer-dist -
--prefer-dist强制走压缩包而非 Git 克隆,配合镜像后整体提速明显
镜像只是解决 packagist.org 的瓶颈,真正卡点常藏在 Git、ZIP 解压或 autoload 生成阶段。切完源记得清缓存,再看 -vvv 输出里最后一行请求地址,才是真实生效的源。

















