换源至阿里云或腾讯云镜像可显著提升 Composer 下载速度。阿里云镜像稳定同步快，推荐全局配置：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/；腾讯云适合南方用户。
直接换源，用阿里云或腾讯云镜像，能立竿见影解决 Composer 下载慢问题。官方源 packagist.org 位于海外，国内直连常超时或限速；而阿里云、腾讯云等镜像已全量同步元数据和 ZIP 包，并通过 CDN 加速，实测安装速度可提升 3–10 倍。
全局配置镜像源（推荐：一劳永逸）
执行一次，所有新老项目自动走国内源，无需重复操作。注意命令中 -g 表示 global，且 repo.packagist 是固定键名（不是 repos.packagist，后者是旧写法，部分文档有误）。
- 阿里云（稳定、同步快，首选）：
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
应输出你设置的 URL；或运行composer config -g -l | grep repositories
查看完整配置
单个项目临时切换镜像（隔离性强）
适用于团队协作项目（避免污染他人环境）、CI 构建脚本，或仅想测试某镜像效果。该操作会修改当前目录下的 composer.json，添加 repositories 字段。
- 进入项目根目录后执行（以阿里云为例）：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/
- 此时
composer.json会新增如下结构："repositories": { "packagist": { "type": "composer", "url": "https://mirrors.aliyun.com/composer/" } } - ⚠️ 注意：如果项目已存在
repositories字段，该命令会覆盖整个对象，而非合并 —— 如需保留其他私有仓库，应手动编辑composer.json
恢复官方源或排查失败原因
换源后若出现依赖解析异常（如 Could not find package xxx），大概率是镜像同步延迟（极少数情况）或配置写错。先确认是否真在用镜像源，再决定是否回退。
- 查看当前生效的源：
composer config -l | grep repositories.packagist
（不加-g可同时看到项目级 + 全局级配置） - 删除全局镜像（恢复默认）：
composer config -g --unset repos.packagist
（注意是repos.packagist，不是repo.packagist） - 常见坑：
– PHP 禁用了putenv()或proc_open()（见php.ini的disable_functions），会导致composer命令直接报错，与镜像无关；
– 镜像 URL 末尾多写了斜杠（如https://mirrors.aliyun.com/composer//）或少了https://，会静默失效；
– 某些老旧 Composer 版本（
镜像不是万能加速器——它只加速元数据读取和 ZIP 包下载，但若依赖包本身托管在 GitHub/GitLab，且这些平台在国内访问仍不稳定，Composer 仍可能卡在 “Downloading xxx.zip” 阶段。此时需配合 Git 镜像（如 git clone 时替换 host）或改用 --prefer-dist 强制走 ZIP 分发。不过对绝大多数 Laravel、Symfony 等主流包，阿里云/腾讯云镜像已足够可靠。
