最稳妥方式是用 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 永久切换全局镜像源；临时切换则用 --repository-url 参数或 COMPOSER_REPO_PACKAGIST 环境变量，不修改配置文件。
如何用 composer config 临时或永久修改镜像源
直接改全局配置最稳妥，避免每次 install/update 都手动指定。执行以下命令即可把 packagist.org 切换为阿里云镜像：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
注意三点：
-
-g表示全局生效（写入~/.composer/config.json），不加则只影响当前项目（写入./composer.json） - 必须写
composer作为 type，不能省略或写成packagist - URL 结尾不要加
/packages.json或其他路径，否则会报Could not parse version constraint
遇到 Invalid repository type "composer" 怎么办
这是 Composer 2.0+ 对镜像源 type 的校验变严格了——老版本允许写 packagist，新版本只认 composer。如果执行 composer config 后报这个错，说明你用了过时的配置方式。
正确做法是删掉旧配置再重设：
composer config -g --unset repos.packagist<br><pre class="brush:php;toolbar:false;">composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
常见诱因：
- 从低版本 Composer 升级后残留了
"type": "packagist" 字段 - 手写
config.json时拼错了 type 值 - 某些脚本用
composer config repos.packagist没带composer类型参数
国内常用镜像源 URL 和兼容性差异
不是所有镜像都支持完整 Packagist 协议，部分镜像在处理 require-dev 或私有包时会失败。实测可用的主流源如下：
- 阿里云：
https://mirrors.aliyun.com/composer/（推荐，同步快，支持 HTTPS 和完整元数据） - 腾讯云：
https://mirrors.cloud.tencent.com/composer/（偶尔延迟 10–30 分钟） - 华为云：
https://repo.huaweicloud.com/repository/php/（需注意路径末尾无斜杠，且不支持某些 legacy 插件）
慎用已停更或文档缺失的镜像，比如某些高校源长期未同步 packages.json，会导致 composer update 卡在 “Loading composer repositories” 阶段。
临时切换镜像源（不改配置）的应急方法
当 CI 环境或临时调试需要绕过本地配置时，可以用环境变量覆盖：
COMPOSER_REPO_PACKAGIST=https://mirrors.aliyun.com/composer/ composer install
或者用 --repository-url 参数（仅限 install/update，不适用于 create-project）：
composer install --repository-url=https://mirrors.aliyun.com/composer/
注意：
- 参数方式优先级高于
config.json，但不会持久化 -
--repository-url会完全替换默认源，不合并；若项目依赖私有仓库，需额外用--repository显式声明 - CI 脚本中建议用环境变量方式，避免污染构建目录下的
composer.json
镜像源本身不解决 lock 文件冲突或 PHP 版本不匹配问题，切完源如果还卡在 dependency resolution，得回头检查 composer.json 里的约束是否过于宽松或矛盾。
