必须临时切换阿里云镜像:执行COMPOSER_REPO_PACKAGIST=https://mirrors.aliyun.com/composer/ composer install -vvv,不修改配置,退出终端即失效;永久设置则运行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/并执行composer clear-cache验证。

Composer 默认源在国外,国内直接 composer install 经常卡在 Downloading... 或报 Connection timed out 错误——换镜像不是“锦上添花”,而是必须步骤。
怎么临时切换到阿里云镜像?
适合单次调试或 CI 环境快速验证,不改全局配置:
- 执行命令时加
-vvv可看到真实下载地址,确认是否已走镜像 - 临时指定镜像:运行
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 注意:
repo.packagist是 key 名,不能写成packagist.org或漏掉composer协议前缀 - 临时生效后,
composer create-project也会走该镜像,但下次新终端仍需重设
如何永久设置并验证是否生效?
永久配置写入 ~/.composer/config.json(Windows 是 %USERPROFILE%\AppData\Roaming\Composer\config.json),别手动编辑,用命令更安全:
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论(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/ - 检查结果:执行
composer config -g repo.packagist,应输出完整镜像 URL - 常见坑:如果之前用过
composer config --global repos.xxx自定义过其他源,可能冲突,建议先composer config -g --unset repos清空再设 - 验证方式:删掉
vendor/和composer.lock,跑一次composer install,看日志里下载域名是不是mirrors.aliyun.com
为什么换了镜像 still 慢或失败?
镜像本身没问题,但实际卡点常在本地环境或 Composer 版本:
- Composer 2.2+ 默认启用插件机制,某些旧插件(如
hirak/prestissimo)已废弃,反而拖慢甚至报Class not found错误,建议卸载:composer global remove hirak/prestissimo - PHP 的
openssl扩展未启用会导致 HTTPS 请求失败,运行php -m | grep openssl确认 - 公司网络若启用代理,
HTTP_PROXY环境变量可能干扰 Composer 直连镜像,临时清空:unset HTTP_PROXY HTTPS_PROXY - 镜像同步有延迟(通常 composer config -g repo.packagist composer https://packagist.org
镜像只是加速手段,真正要稳,得让 Composer 自己不“多事”:关掉不必要的插件、确认 PHP 环境干净、别让代理和镜像打架。这些细节没调好,换十个镜像也没用。

















