快速切换 Composer 镜像源用 composer config -g repo.packagist [镜像地址] 一行命令即可，阿里云、腾讯云等国内源可显著提升下载速度并避免超时；全局配置优于修改 composer.json，安全且不污染项目。
怎么快速切换 Composer 镜像源（命令行一行搞定）
Composer 默认走国外源，composer install 卡在 Downloading... 或报 Connection timed out 是常态。国内用阿里、腾讯、华为镜像最稳，切源本质就是改 composer.json 里的 repositories 配置，或全局设 config repo.packagist。
实操建议直接用 composer config 命令覆盖全局设置，不用碰项目级配置，也避免污染 composer.json：
- 切阿里云：
composer config -g repo.packagist https://mirrors.aliyun.com/composer/ - 切腾讯云：
composer config -g repo.packagist https://mirrors.cloud.tencent.com/composer/ - 恢复默认（删掉自定义源）：
composer config -g --unset repos.packagist
注意：-g 表示全局，影响所有项目；不加 -g 则只改当前目录下的 composer.json。别手抖漏掉 -g 又以为切成功了——查证方法是运行 composer config -g repo.packagist，有输出即生效。
为什么 composer config 比改 composer.json 更安全
很多人习惯手动编辑 composer.json，加一段 "repositories" 数组。这看似直观，但容易出问题：
- 多个项目混用同一份
composer.json模板时，镜像地址会随模板一起提交到 Git，泄露内部配置或导致协作冲突 -
repositories顺序敏感：如果写成{"packagist.org": false}但没把新源排第一，Composer 仍可能 fallback 到官方源 - 某些私有包场景下，全局镜像 + 项目级
repositories叠加，触发Package not found错误，排查成本高
而 composer config -g 写入的是 ~/.composer/config.json，完全隔离于项目，且优先级高于项目配置，逻辑干净。
composer diagnose 报 Repo is not configured properly 怎么办
这不是错误，是提示：你用了非标准源，但没显式关闭 packagist.org 的自动映射。Composer 5.0+ 默认开启 packagist.org 自动代理，和镜像源共存时会警告。
- 解决方法是显式禁用默认源：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/（注意末尾多了composer类型标识） - 或者更彻底：
composer config -g repos.packagist false，再单独加镜像：composer config -g repos.aliyun composer https://mirrors.aliyun.com/composer/ - 验证是否生效：
composer config -g repos应该输出带type: "composer"的对象，而不是空或只有false
漏掉 type: "composer" 是常见坑——没声明类型，Composer 就当它是普通 HTTP 源，不走包解析流程，后续所有操作都失败。
CI/CD 环境里镜像源失效的典型原因
GitHub Actions、GitLab CI 跑 composer install 时突然变慢或失败，往往不是源本身挂了，而是环境没继承你的本地全局配置。
- Docker 容器默认没有
~/.composer/config.json，每次都要重设，建议在 CI 脚本开头加一行：composer config -g repo.packagist https://mirrors.aliyun.com/composer/ - 某些基础镜像（如
php:8.2-cli）自带旧版 Composer，不支持repo.packagist的新语法，会静默忽略配置——用composer --version确认 >= 2.5.0 - 缓存干扰：CI 中启用了
composer-cache，但缓存里存的是旧源下载的包，换源后可能复用失败。建议换源后加--no-cache跑一次，或清空~/.composer/cache
最稳妥的做法：不在 CI 中依赖“已配置好”的状态，每次执行前明确设源、验版本、清缓存（如有必要）。自动化的事，少靠“应该已经好了”这种假设。
