应优先配置国内镜像源，运行composer config -g repo.packagist验证，若返回{"type": "composer", "url": "https://packagist.org"}或空，说明未生效，正直连官方源导致超时失败。
Composer 报错时，80% 以上和网络超时或源不可达有关，优先换国内镜像能快速绕过卡顿、Connection timed out、Could not fetch packages 这类问题。
怎么确认当前用的是哪个镜像源
运行 composer config -g repo.packagist。如果返回 {"type": "composer", "url": "https://packagist.org"} 或空结果，说明没设镜像，正直连官方源——这在国内大概率失败。
- 官方源
https://packagist.org域名解析慢、TLS 握手常超时，尤其在非夜间时段 - 阿里云、腾讯云、华为云镜像都已同步完整，且支持 HTTPS + HTTP/2，响应通常
- 别信“自动选 fastest mirror”类插件，它们测速逻辑不覆盖 Composer 的真实请求链路（如 metadata 加载、zip 下载）
一键切换到阿里云镜像（推荐）
执行这条命令即可全局生效：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
注意：composer 是 type 字段值，不是命令；https://mirrors.aliyun.com/composer/ 结尾不能带 /packages.json 或其他路径。
- 换源后首次运行
composer install会重刷缓存，可能稍慢，但后续速度明显提升 - 若项目里已有
composer.json中写了"repositories"，它会覆盖全局配置，需手动删或改掉 - 某些企业内网禁外网 HTTPS，可临时降级用 HTTP 镜像（如
http://mirrors.cloud.tencent.com/composer/），但仅限调试，不建议长期用
遇到 Unable to load autoload.php 不是镜像问题
这个错误和镜像无关，是 vendor/autoload.php 没生成或路径引用错。常见于：
-
composer install执行中途被 Ctrl+C 中断，导致vendor/不完整 - 误删了
vendor/但没重新install，只跑了dump-autoload - PHP CLI 和 Web Server 用的不是同一套扩展（比如 CLI 开了
openssl，而 Apache 没开），导致composer install在 CLI 成功，但 Web 环境加载失败
此时换镜像没用，先跑 rm -rf vendor && composer install 再验证。
CI/CD 环境中镜像要显式声明
GitHub Actions、GitLab CI 默认不继承你的本地配置，每次构建都是干净环境。
- 在
.github/workflows/composer.yml中加一步：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 或者更稳妥：把镜像 URL 写进
composer.json的repositories字段，避免依赖全局状态 - Docker 构建时，别在
FROM php:xxx后直接RUN composer install，先RUN composer config -g ...再装依赖
镜像配置本身很简单，但容易被当成“试试看”的次要动作——实际上它是 Composer 在国内可用的前提，不是锦上添花，而是雪中送炭。没配镜像就调依赖、查报错，相当于蒙眼修车。
