镜像配置没生效的三个硬伤是：键名必须为repo.packagist（不可多s或错写）、第二个参数必须显式指定composer类型、url须以https://开头且末尾带斜杠；任一缺失均静默回退官方源，需用composer config -g repo.packagist验证输出是否为完整json。
镜像配置没生效？三个硬伤必须当场验证
配了镜像却还是卡在 Loading composer repositories 或 Resolving dependencies，大概率不是网络问题，而是配置静默失败。Composer 对 repo.packagist 的校验非常严格，漏掉任意一个细节就 fallback 回官方源：
-
repo.packagist是唯一合法键名 —— 写成repos.packagist（多一个 s）或packagist.org都无效 - 第二个参数必须是
composer（仓库类型声明），漏掉它，命令不报错但直接忽略 - URL 必须以
https://开头且末尾带斜杠：https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（少斜杠会拼出 404 路径）
验证是否真写进去了：运行 composer config -g repo.packagist，输出必须是完整 JSON 或至少是字符串 "https://mirrors.aliyun.com/composer/"；如果为空、null 或仍是 https://packagist.org，说明根本没生效。
内存溢出不是 Composer 慢，是 PHP 进程被卡死
Allowed memory size exhausted 报错，95% 的情况跟 Composer 本身无关，而是 PHP CLI 启动时被 memory_limit=128M 硬卡死。Composer 解析几百个包的 composer.json、生成 autoload 映射时，真实峰值常超 1G。
- 最稳解法永远是：
php -d memory_limit=-1 composer install—— 它在 PHP 进程启动瞬间覆盖限制，不改配置、不重启服务，只作用于当前命令 - Windows PowerShell 用户必须加引号：
php -d "memory_limit=-1" composer install，否则-1可能被 shell 截断 - 用
composer.phar时写法不变：php -d memory_limit=2G composer.phar update（单位必须大写 G） - CI/CD 中建议用具体值而非
-1，比如php -d memory_limit=1.5G composer install，防止单次异常拖垮构建节点
镜像和内存必须联动调优，单边优化等于白干
光换镜像不调内存，下载快了但解析阶段照样崩；光提内存不换源，PHP 能撑住，但等元数据下载半小时也受不了。两者要一起上：
-
--no-dev：跳过require-dev解析，内存常降 40%~60%，上线部署必加 -
--optimize-autoloader（或-o）：生成扁平 classmap，降低dump-autoload阶段内存峰值 -
--prefer-dist：强制走 zip 包而非 git clone，避免额外 git 进程吃内存（国内镜像只缓存 dist，不缓存 source） - 检查项目级配置：
"prefer-source": true会悄悄覆盖全局--prefer-dist，需手动删掉或执行composer config --unset prefer-source
为什么 COMPOSER_MEMORY_LIMIT=-1 还报错
因为这个环境变量只影响 Composer 自身的内存预分配逻辑（比如依赖回溯步数），完全无法突破 PHP 底层的 memory_limit。即使设了它，只要 PHP 进程启动时被卡在 128M，照样报错。
-
COMPOSER_MEMORY_LIMIT的优先级低于php -d memory_limit，两者共存时以后者为准 - 它适合做“二次防护”：比如 CI 中搭配使用
php -d memory_limit=2G COMPOSER_MEMORY_LIMIT=1536M composer install - Linux/macOS 用
export COMPOSER_MEMORY_LIMIT=1536M；Windows CMD 用set COMPOSER_MEMORY_LIMIT=1536M；PowerShell 用$env:COMPOSER_MEMORY_LIMIT="1536M"
真正容易被忽略的是：镜像 URL 少斜杠、键名多字母、php -d 放错位置 —— 这些错误不会报错，但会让所有调优动作失效。每次配完，务必用 composer config -g repo.packagist 和 php -r "echo ini_get('memory_limit');" 交叉验证。
