全局开启国内镜像源需执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/（阿里云）等命令，注意字段名是 repo.packagist 而非 repos.packagist，配置前需先清理旧配置 composer config -g --unset repos.packagist，验证用 composer config -g repo.packagist，还原默认源应使用 --unset 删除配置项而非替换为官方url。
怎么全局开启阿里云或腾讯云镜像源
直接改 Composer 的全局配置，所有项目立刻走国内源，不用每个项目单独设。这是最省事、也最推荐的起步方式。
- 阿里云镜像（同步快、稳定性高，首选）：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 腾讯云镜像（南方用户延迟更低）：
composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/ - 中国科大镜像（学术网络友好）：
composer config -g repo.packagist composer https://mirrors.ustc.edu.cn/composer/
注意：repo.packagist 是固定键名，不是 repos.packagist —— 写错字段名会导致配置无效，且不会报错，容易误以为“设成功了”。
为什么有些命令没生效？常见配置陷阱
配置后 composer install 还慢，或者 composer config -g repo.packagist 返回空，大概率是掉进了这几个坑：
- 之前用过旧镜像（比如 Laravel China 或 phpcomposer），残留了
repos.packagist（带 s）配置，和新的repo.packagist冲突，得先清理：composer config -g --unset repos.packagist - 执行命令时漏了
-g，结果只改了当前项目（写入了composer.json），但你其实想全局改 - 用了
sudo或切换了用户执行命令，导致改的是另一个用户的~/.composer/config.json - 验证方式错误：别只看
composer config -g，要加具体字段：composer config -g repo.packagist，输出应为{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
怎么只对当前项目启用镜像（不污染全局）
适合团队协作、CI 构建，或你只是临时测试某个镜像效果。它会把配置写进当前项目的 composer.json，不影响其他项目。
- 进入项目根目录后执行（以阿里云为例）：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/ - 该命令会向
composer.json插入"repositories"字段，结构如下：
"repositories": {
"packagist": {
"type": "composer",
"url": "https://mirrors.aliyun.com/composer/"
}
}
⚠️ 注意：如果项目已有 "repositories" 字段，这个命令会**完全覆盖**它，而不是合并。需要保留私有仓库时，必须手动编辑 composer.json。
如何干净还原到官方源（恢复默认）
不是简单换回 URL，而是彻底移除自定义源配置，让 Composer 自动 fallback 到 https://packagist.org。
- 全局还原（所有项目）：
composer config -g --unset repos.packagist - 仅当前项目还原：
composer config --unset repositories.packagist（注意这里用--unset而非repo.packagist） - 还原后建议清缓存：
composer clear-cache，避免旧镜像的元数据干扰依赖解析
别用 composer config -g repo.packagist composer https://packagist.org —— 这样只是硬编码官方地址，仍属于“自定义源”，后续升级 Composer 可能行为异常；真正干净的做法是删掉配置项本身。
最容易被忽略的一点：镜像源解决的是「索引获取慢」，不是「包文件下载慢」。如果 composer update 卡在 downloading zip 包阶段，问题可能出在 CDN 或本地网络，跟镜像源关系不大。这时候该查的是 composer diag 输出里的 HTTP proxy 或 openssl version 是否异常。
