最稳妥的全局配置方式是执行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，该命令直接写入~/.composer/config.json，使后续所有composer install/update自动使用阿里云镜像，无需重启终端或清缓存。
直接执行这条命令就能全局生效
最稳妥、最常用的方式就是运行：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/。执行完这行命令，所有后续的 composer install 和 composer update 都会自动走阿里云镜像，不用再改项目、不用重启终端、也不用清缓存——它直接写进你的全局配置文件 ~/.composer/config.json 里。
验证是否成功？运行：composer config -g repo.packagist，输出应该是：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。如果不是，说明命令没执行对，或者权限不足（比如用了 sudo 写错位置）。
为什么推荐阿里云，而不是腾讯云或 Laravel China
阿里云镜像同步频率高、HTTPS 稳定、全量索引完整，基本不存在“包有但搜不到”或“版本不一致”的问题。而腾讯云镜像偶发同步延迟（比如新发布的 laravel/framework v11.0.0 可能晚几小时才上线），Laravel China 镜像已于 2025 年底停止维护，访问会返回 404。
- 腾讯云地址是
https://mirrors.cloud.tencent.com/composer/，如真要试，记得末尾斜杠不能少 - 别用
http://开头的旧地址——Composer 2.x 默认禁用非 HTTPS 源，会报Invalid repository type, expected 'composer' - 阿里云镜像不支持上传私有包，纯下载场景下它就是目前最优解
项目级配置：只给当前项目换源，不影响别人
进到项目根目录后，去掉 -g 参数即可：composer config repo.packagist composer https://mirrors.aliyun.com/composer/。这条命令会往你项目的 composer.json 里加一段 "repositories" 配置，团队协作时更容易统一源，也方便 Git 跟踪。
但要注意：composer.json 中手动添加的 repositories 字段优先级高于全局配置，一旦写了，就以它为准；如果删掉又忘了清缓存，composer install 可能仍走旧源——这时候得补一句：composer clear-cache。
fallback 备用源：官方源挂了自动切镜像（仅 Composer ≥2.2）
如果你既想保持和 packagist.org 的兼容性（比如某些包只在官方发布），又怕它抽风，可以启用 fallback 机制：
先添加一个带 fallback 标志的镜像：composer config -g repositories.packagist composer https://mirrors.aliyun.com/composer/composer config -g repositories.packagist.fallback true
这样 Composer 会先尝试官方源，失败后（如超时、证书错误、Connection refused）才降级到阿里云。但注意：
- 必须是 Composer 2.2+ 才支持，老版本会报 Unknown configuration setting
- 不要给多个源都设 fallback: true，Composer 只认第一个
- 测试时可临时屏蔽 packagist.org：在 /etc/hosts 加一行 127.0.0.1 packagist.org，再跑 composer show -v monolog/monolog 看日志是否切换
真正容易被忽略的是 fallback 的触发条件——它只在连接层失败时兜底，如果官方源返回了 404 或 403（比如包被删），fallback 不会生效。所以日常开发，还是建议直接用阿里云全局替换，简单、确定、省心。
