composer下载慢的根本原因是默认源packagist.org位于境外，受网络波动和dns解析影响；换国内阿里云或腾讯云镜像最有效，需注意同步延迟与版本兼容性，并优先采用项目级配置禁用默认源。
Composer 下载慢，本质是默认源 packagist.org 位于境外，国内直连受网络波动和 DNS 解析影响大。换国内镜像源是最直接有效的解决方式，但要注意镜像同步延迟和 Composer 版本兼容性。
确认当前源并切换为阿里云或腾讯云镜像
执行 composer config -g repo.packagist 可查看当前全局源；若返回 https://packagist.org，说明未配置镜像。推荐优先使用阿里云或腾讯云镜像，它们同步及时、稳定性高，且支持 HTTPS。
- 切换为阿里云镜像：
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 --unset repos.packagist
遇到 Could not fetch 或 file could not be downloaded 错误
这类错误常因镜像未及时同步新包、或本地缓存损坏导致。不要立刻换源，先尝试清理并强制刷新：
- 清除 Composer 缓存：
composer clear-cache
- 更新包列表（不安装）：
composer update --dry-run
- 若仍失败，临时禁用 HTTPS 验证（仅调试用，不推荐长期开启）：
composer config -g secure-http false
- 检查是否被公司代理或防火墙拦截：可临时关闭代理，或设置
HTTP_PROXY环境变量指向可用代理
项目级镜像配置比全局更安全
全局镜像在团队协作中可能引发意外行为（例如 CI 环境依赖默认源），建议在项目根目录的 composer.json 中显式声明源：
{
"repositories": [
{
"type": "composer",
"url": "https://mirrors.aliyun.com/composer/"
}
],
"packagist.org": false
}
注意："packagist.org": false 是关键，它会彻底禁用默认源，避免 fallback 到慢速源。该配置对 composer install 和 composer require 均生效。
PHP 版本与 Composer 版本不匹配导致卡在 Loading composer repositories
旧版 Composer（如 1.x）在 PHP 8+ 下可能无法正确解析新版包元数据，表现为长时间卡住或报 failed to open stream。这不是网络问题，而是兼容性问题：
- 检查当前版本：
composer --version
- 升级到 Composer 2.x（PHP 7.4+ 推荐）：
composer self-update
- 若因权限问题升级失败，改用安装脚本方式：
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');" php composer-setup.php --install-dir=/usr/local/bin --filename=composer
镜像再快，底层解析失败也白搭；务必确认 composer 和 php 版本组合是官方支持的。
