Composer install 卡在 packagist.org 是因官方源对国内直连不友好，DNS 解析慢、TLS 不稳、路由抖动导致超时或404；可通过全局配置腾讯、阿里或华为镜像（如 composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/）加速，但新包/私有包可能未同步，需手动验证或临时切回官方源。
为什么 composer install 总卡在 packagist.org？
因为默认源在国外，DNS 解析慢、TLS 握手不稳定、中间路由抖动，导致超时或 404。不是你网络差，是官方源对国内直连不友好。镜像本质是把 packagist.org 的元数据和 ZIP 包缓存到国内服务器，请求走 CDN，延迟从秒级降到毫秒级。
怎么全局切换到腾讯、阿里或华为镜像？
别改每个项目的 composer.json，直接改全局配置：
- 腾讯镜像（推荐）：
composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/ - 阿里云镜像：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 华为云镜像：
composer config -g repo.packagist composer https://repo.huaweicloud.com/composer/
执行后会写入 ~/.composer/config.json，所有项目自动生效。注意：如果之前设过 per-project 镜像，-g 参数才能覆盖全局。
某些包仍提示 Could not find package xxx 怎么办？
不是镜像没生效，而是这个包没被镜像同步——尤其是私有包、新发布不到 1 小时的包、或带自定义 repositories 的项目。检查方式：
立即学习“PHP免费学习笔记（深入）”；
- 运行
composer config repo.packagist确认当前源地址 - 手动访问镜像站首页（如
https://mirrors.cloud.tencent.com/composer/），搜索包名看是否存在 - 临时退回到官方源验证：
composer config -g repo.packagist composer https://packagist.org
遇到未同步包，要么等镜像定时抓取（通常 30 分钟内），要么在项目级 composer.json 中单独加 repositories 指向原始源。
CI/CD 环境里镜像配置容易失效？
很多 CI 脚本用 composer install --no-interaction，但没保证镜像已设置。Docker 构建或 GitHub Actions 中常见问题：
- 镜像配置只对当前用户生效，CI 容器常以 root 或无家目录用户运行，
-g不起作用 - 解决方案：在
composer install前加一行composer config repo.packagist composer https://mirrors.cloud.tencent.com/composer/（不带-g，作用于当前项目） - 更稳妥做法：把镜像 URL 写进项目
composer.json的repositories字段，避免环境依赖
镜像不是万能加速器，它解决的是「下载路径」问题，而不是 autoload 性能或扩展缺失。真卡在 autoload_classmap.php 生成阶段，换镜像也没用。
