正确配置为composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，必须严格满足三要素：键名repo.packagist（单数）、type值composer、URL以HTTPS开头且末尾带斜杠，缺一即静默失效。
composer config -g repo.packagist 命令写错就白配
国内用 Composer 不配镜像，基本等于没法装依赖——不是慢，是大概率失败。超时、403、卡在 Downloading，根源全在直连 packagist.org。但 90% 的人配不成功，不是网络问题，是命令写错了三个硬性细节：
-
repo.packagist是固定键名，拼成repos.packagist（多一个 s）或packagist.org都静默失效 - 中间那个
composer是 type 参数，不是可选、不是注释，漏掉它就 fallback 回官方源 - 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，说明没写进去。
宝塔、Docker、CI 里全局配置经常不生效
你在终端用 root 执行了 composer config -g，但宝塔后台以 www 用户运行，它读的是 /home/www/.composer/config.json，根本看不到 root 的配置；CI 脚本里用 sudo composer config -g，结果写进了 root 配置，而容器里实际跑的是 runner 用户——配置完全错位。
更稳妥的做法是进项目根目录，去掉 -g 直接运行：
立即学习“PHP免费学习笔记（深入）”；
composer config repo.packagist composer https://mirrors.aliyun.com/composer/
它会自动往 composer.json 的 repositories 字段安全追加，不覆盖已有私有源。这个改动能提交到 Git，团队拉代码后行为一致。注意：如果项目已有 "repositories": []（数组），命令会报错，得先手动改成 "repositories": {}（对象）。
换镜像后还卡在 Resolving dependencies？和镜像无关
镜像只加速元数据拉取和 ZIP 下载，不解决依赖解析慢的问题。如果你发现 composer update 卡在 Resolving dependencies 几十秒甚至几分钟，基本可以确定是本地环境或 composer.json 写法导致的：
- PHP 版本约束太宽，比如
"php": "^7.4 || ^8.0"，会让 Composer 尝试大量组合 - 大量未锁定版本的 dev 包（如
"monolog/monolog": "dev-main"） -
require-dev里塞了太多工具，或启用了xdebug - PHP 内存不足（
memory_limit小于 1G 容易崩）
验证方式：加 -vvv 运行，盯紧输出里的 URL —— 如果一直是 GET https://mirrors.aliyun.com/composer/，说明镜像已生效，卡点在解析层；如果还有 packagist.org 请求，说明镜像根本没切过去。
别忽略缓存和 prefer-dist 的协同作用
--prefer-dist 告诉 Composer 优先下载 ZIP 包，但它只对镜像源有效。国内镜像（阿里云、腾讯云）几乎只缓存 dist 包，不缓存 source。如果镜像没生效，--prefer-dist 就会 fallback 到 clone Git 仓库，反而更慢甚至失败。
必须同步执行：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/<br>composer clear-cache
另外检查项目 composer.json 里有没有 "config": {"prefer-source": true}，它会覆盖全局 prefer-dist，必须手动删掉。并行下载也得配：Composer 2.2+ 支持 parallel-downloads=10，但默认是 3，基本等于没开。
