必须换镜像源，且需严格满足三个条件：键名必须为repo.packagist（单数、无s）、第二参数必须是composer（声明类型）、URL必须以https://开头且结尾带/，否则静默回退到packagist.org。
必须换镜像源，且不能只配一次就完事——大型单体应用的依赖解析和下载压力远超普通项目，镜像配置错一个字符、漏一个斜杠、用错 type 值，都会导致静默 fallback 到 packagist.org，整个构建卡在 Downloading 或 Resolving dependencies 阶段。
composer config -g repo.packagist 命令为什么总不生效
90% 的“配了还是慢”问题，源于这条命令敲得不精确。它不是“设个 URL”那么简单，而是要同时满足三个硬性条件：
-
repo.packagist键名不能多写 s（repos.packagist是 Composer 1.x 的旧写法，2.x+ 不识别，也不报错，直接忽略） - 第二个参数必须是
composer—— 这是仓库类型声明，缺了它，Composer 就当没这回事，自动回退到官方源 - URL 必须以
https://开头，且末尾带/（https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌，少斜杠会导致路径拼接错误，返回 404）
验证是否真正写入：运行 composer config -g repo.packagist，输出应为完整 JSON：{"type":"composer","url":"https://mirrors.aliyun.com/composer/"}。如果为空、null 或仍显示 packagist.org，说明根本没生效。
宝塔、CI、systemd 里 composer install 还是慢
因为这些环境默认以非登录用户身份运行（如 www、runner、www-data），而 composer config -g 默认只写当前 shell 用户（比如 root）的配置。结果就是你在终端里跑得飞快，宝塔后台或 GitLab CI 却还在原地打转。
立即学习“PHP免费学习笔记（深入）”；
- 查实际执行用户：在宝塔【终端】里执行
sudo -u www whoami，确认是www - 用对应用户重配：
sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - CI 脚本中别依赖全局配置，改用临时参数更可靠：
COMPOSER_MEMORY_LIMIT=-1 php -d xdebug.mode=off $(which composer) install --no-dev --prefer-dist --no-autoloader --no-scripts
项目级配置比全局更稳，但要注意 repositories 覆盖逻辑
进项目根目录后执行 composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加 -g），它会向 composer.json 的 repositories 数组里追加一条 "packagist" 记录，不会清空已有的私有 Git 源。但注意：
- 如果项目
composer.json已手动定义了"repositories": []，且里面没有"packagist"条目，该命令会补上；但如果已有"packagist.org": false或其他结构，建议手动编辑，确保"packagist": {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}在数组内，且"packagist.org": false写在根节点（非repositories下） - 首次切换镜像后，必须删掉
vendor/和composer.lock，再跑composer install --no-cache。旧lock文件里的哈希值来自 packagist.org，和镜像源元数据不兼容，强行保留会触发hash does not match报错
换镜像后还卡在 Resolving dependencies 怎么办
这个阶段完全不走网络，镜像再快也没用。真实瓶颈往往藏在 PHP 环境和依赖结构里：
-
COMPOSER_MEMORY_LIMIT=-1临时放开内存限制（默认 128M 对大型单体常不够） - 确认没启用 Xdebug：
php -v看输出是否含xdebug，有则用php -d xdebug.mode=off $(which composer)临时禁用 - 检查
composer.json中"platform"配置是否与当前 PHP 版本匹配（如"php": "7.4"却在 PHP 8.2 上运行，会触发降级查找逻辑） -
http-max-concurrent-downloads替代已弃用的parallel-downloads：composer config -g http-max-concurrent-downloads 10
大型单体最易被忽略的是：换镜像只是第一步，后续所有环节（内存、Xdebug、platform、lock 文件清理）都必须同步调整，否则永远卡在“以为配好了”的假象里。
