composer国内使用必须配置镜像，否则因直连packagist.org易超时、403或卡在downloading；关键需正确执行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，确保字段名无误、type参数显式指定、url为https且末尾带斜杠。
国内用 Composer 不配镜像，基本等于没法装依赖——不是慢，是大概率失败。超时、403、卡在 Downloading，根源全在直连 packagist.org。配镜像不是“提速技巧”，而是能跑起来的前提。
composer config -g repo.packagist 命令必须写对这三处
90% 的配置失败不报错，但完全不生效。关键就卡在这三个细节：
-
repo.packagist不能拼成repos.packagist（多一个s就失效） - 必须显式传
composer作为 type 参数：正确是composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，漏掉中间那个composer就白写 - URL 必须是 HTTPS + 末尾带斜杠：
https://mirrors.aliyun.com/composer/✅，http://❌，https://mirrors.aliyun.com/composer（缺斜杠）❌
验证方式很简单：执行 composer config -g repo.packagist，输出必须是完整 URL 字符串（新版）或 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}（旧版）。空、null、或还是 https://packagist.org，说明没写进去。
全局配置 vs 项目级配置：什么时候该用哪个
全局配置省事，但有隐藏风险；项目级更稳妥，尤其团队协作时：
- 全局配置（
composer config -g ...）改的是~/.config/composer/config.json，所有项目共享。适合个人开发，或团队统一初始化脚本中固化 - 项目级配置（去掉
-g，在项目根目录运行）会往composer.json的repositories字段里追加，只影响当前项目。如果项目已有repositories，命令会自动合并，不会覆盖私有源 - 宝塔、Docker 或 CI 环境中要注意用户身份：宝塔默认以
www用户运行，而root下配的全局配置它读不到。得切到对应用户下配，比如sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
换镜像后还是卡？先看日志里卡在哪一步
加 -vvv 运行 composer install -vvv，盯紧输出里的关键词：
- 大量
GET https://mirrors.aliyun.com/composer/...或Downloading xxx.zip→ 镜像已生效，下载环节正在加速 - 长时间停在
Resolving dependencies→ 和镜像无关，是本地 PHP 内存不足、启用了xdebug、composer.json里版本约束太宽（比如"*"）、或config.platform.php与实际 PHP 版本不匹配导致的求解器爆炸 - 出现
GithubRateLimitException或一堆403→ 说明某些包硬编码了 GitHub dist URL，需单独处理 GitHub 访问（如配 token 或换源）
镜像只管下载，不参与依赖解析。卡在这步，再换十个镜像也没用。
阿里云、清华、腾讯云镜像怎么选
三者同步延迟都在 5 分钟内，CDN 覆盖广，稳定性接近。差异在于网络路径和个别环境适配：
- 阿里云（
https://mirrors.aliyun.com/composer/）社区反馈最多，问题响应快，推荐作为第一选择 - 清华源（
https://mirrors.tuna.tsinghua.edu.cn/composer/）路径结构稍不同，某些企业防火墙会拦截含mirrors.的 HTTPS 域名，换清华源常能绕过 SSL 错误 - 腾讯云（
https://mirrors.cloud.tencent.com/composer/）在华南地区延迟略优，可作为备选 - 别用已停用的
https://packagist.phpcomposer.com（2025 年底下线）
Composer 2.2+ 默认开启官方源回退机制：镜像返回 404 或 503 时会自动切回 packagist.org 查一次。这个保险丝别关——关了反而会让新包直接报错，而不是兜底。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
