国内使用 Composer 必须配置镜像源，否则因 packagist.org 限速、超时、403 等问题无法正常安装；推荐阿里云或清华镜像，全局配置命令为 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，配完需验证输出是否为该 URL。
不配镜像，Composer 在国内基本没法用——不是慢，是根本装不完。 卡在 Downloading...、超时、403 GitHub 限速，全是因为默认走 packagist.org。镜像不是“优化项”，而是国内 PHP 开发的启动前提。
怎么确认你还没配镜像？
执行 composer config -g repo.packagist。如果输出为空、或显示 {"type":"composer","url":"https://packagist.org"}，说明还在直连官方源。新版 Composer（2.2+）会显示纯 URL，旧版才显示 JSON；但只要没出现 mirrors.aliyun.com 或 mirrors.tuna.tsinghua.edu.cn，就等于没生效。
- 运行
composer install -vvv，看日志里下载域名是不是packagist.org—— 是的话，所有加速手段都白搭 - 别信“我加了
--repository就算配了”：临时参数只对当次命令有效，关掉终端就失效 - 项目根目录已有
repositories字段？全局配置会被覆盖，得进项目里再跑一次不带-g的composer config
配哪个镜像最稳？阿里云 or 清华？
阿里云（https://mirrors.aliyun.com/composer/）和清华（https://mirrors.tuna.tsinghua.edu.cn/composer/）目前同步延迟都在 5 分钟内，CDN 覆盖广，故障率低。腾讯云、华为云也可用，但阿里和清华社区反馈更密集、问题响应更快。
- 全局配一个就行：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 别用已停用的
https://packagist.phpcomposer.com，它早在 2025 年底下线 - 配完立刻验证：
composer config -g repo.packagist必须输出完整 URL，不是空或 JSON - 某些企业网络会拦截 HTTPS 域名中的
mirrors.前缀，如果报 SSL 错误，换清华源试试（路径结构稍不同）
为什么配了镜像还是慢？检查这三件事
镜像只解决下载环节，但卡顿可能发生在其他地方。常见真凶：
立即学习“PHP免费学习笔记（深入）”；
-
composer update卡在Resolving dependencies：这是本地依赖解析，和镜像无关，跟composer.json复杂度、PHP 内存限制、平台配置（如platform）强相关 - 日志里出现
GithubRateLimitException或403 rate limit：说明有包硬编码了 GitHub URL（比如老旧dist.url），需配 GitHub Token：composer config -g github-oauth.github.com your_token_here - 删了
vendor直接install还是慢：Composer 仍要解压、校验、生成 autoload —— 加--no-scripts --no-autoloader跳过，装完再补composer dump-autoload
parallel-downloads 设多少合适？
这个参数只对 composer install 有效，且仅 Composer 2.2+ 支持。默认值是 3，等于没开并发。设太高反而触发镜像限流或 DNS 超时。
- 推荐值：
10～15，执行：composer config -g parallel-downloads 15 - 别设到
20以上：阿里云/清华镜像对单 IP 并发有限制，超过易返回 429 - 如果出现
file_get_contents(): SSL operation failed，说明本地网络扛不住高并发，降回8 - 注意：该设置不影响
composer update，它始终串行解析元数据
真正容易被忽略的是 fallback 机制——Composer 2.2+ 默认在镜像 404 或 503 时自动切回 packagist.org 查一次。别手动关掉它，否则新发布的包会直接报错，而不是兜底尝试。
