最稳妥方式是执行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，需严格满足-g、单数键名repo.packagist、type值composer及URL末尾斜杠四要素，否则静默失效。
Composer 默认源在国外，国内直连经常超时或卡死，换镜像不是“锦上添花”，而是“必须操作”——否则 composer install 卡在 Downloading... 或报错 Connection timed out 是常态。
怎么快速切换到阿里云 Composer 镜像
最稳妥的方式是全局配置（影响所有项目），执行一条命令即可：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
注意：repo.packagist 是 Composer 2.2+ 的写法；若用旧版（packagist（无 repo. 前缀）：
composer config -g packagist https://mirrors.aliyun.com/composer/
- 执行后会修改全局配置文件（通常是
~/.composer/config.json），无需手动编辑 - 如果提示
command not found，先确认composer是否已加入系统 PATH - 换源后首次运行
composer update可能稍慢（要重建本地缓存），之后明显提速
项目级镜像配置（不污染全局）
团队协作或临时测试时，更推荐只对当前项目生效：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
composer config repo.packagist composer https://mirrors.aliyun.com/composer/
这条命令不加 -g，会在项目根目录的 composer.json 中写入 repositories 字段。效果等同于手动添加：
"repositories": [
{
"type": "composer",
"url": "https://mirrors.aliyun.com/composer/"
}
]
- 提交
composer.json到 Git 后，其他成员拉取即生效，无需各自配置 - 若项目已有自定义仓库（如私有包），注意
repositories是数组，别覆盖原有项 - 执行
composer config --unset repositories可清空项目级仓库设置
镜像失效或 404？检查这几个关键点
换了镜像仍失败，大概率不是镜像问题，而是本地环境或配置冲突：
-
composer diagnose会提示证书、DNS、代理等基础问题，先跑一遍 - 公司网络可能拦截了
https://mirrors.aliyun.com，可尝试腾讯镜像：https://mirrors.cloud.tencent.com/composer/ - 如果设置了 HTTP 代理（
http_proxy环境变量），而代理本身不稳定，会导致镜像也连不上——临时取消代理再试：unset http_proxy https_proxy - 某些老旧 PHP 版本（如 7.2 以下）不支持 SNI，访问 HTTPS 镜像会报 SSL 错误，此时只能降级用 HTTP（不推荐）或升级 PHP
为什么不用脚本一键换源？
网上流传的“一键换源脚本”往往硬编码路径、忽略 Composer 版本差异，还可能静默修改你原本的仓库配置。直接用 composer config 命令最透明——它只改目标字段，不碰其他配置，出错也能立刻 composer config --unset 回退。
真正容易被忽略的是：镜像只是加速手段，不能掩盖根本问题。比如 composer.lock 里锁死的包版本在国外源已下架，换镜像也装不上——这时得看错误里具体是哪个包失败，再针对性处理。
