Composer全局镜像配置需同时满足三条件才生效：键名必须为repo.packagist（非repos.packagist）、type参数必须为composer、URL须以https://开头且末尾带/；否则静默失效，不报错也不走镜像。
直接执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 就能显著提速，但漏 -g、少末尾斜杠、用错键名 repos.packagist 中任意一个，都会静默失效——不报错，也不走镜像。
为什么 composer config -g repo.packagist 总不生效
这不是网络问题，是配置没写进 Composer 实际读取的位置。三个硬性条件必须同时满足：
-
repo.packagist是唯一有效键名；repos.packagist（多一个 s）会被完全忽略，命令不报错但无效 - 第二个参数必须是
composer，它是 type 声明，漏掉就会 fallback 到https://packagist.org - 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/"}）或至少是该 URL 字符串。若为空、null 或仍是 https://packagist.org，说明根本没生效。
项目级配置为何比全局更可靠
宝塔、CI、Docker 容器里跑的 Composer 往往不是你当前登录的用户，composer config -g 写的是 ~/.composer/config.json，而 www、runner、git 等用户读的是各自家目录下的同名文件——全局配置在这些场景下天然失效。
立即学习“PHP免费学习笔记（深入）”；
- 进项目根目录后执行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉-g），它会自动向composer.json的repositories字段安全追加，不覆盖已有私有源 - 如果项目已有
"repositories": []（数组格式），该命令会失败；需先手动改成"repositories": {}（对象格式）再运行 - 改完务必删掉
vendor/和composer.lock，再执行composer install——旧 lock 文件里的哈希值与镜像元数据不匹配，会报hash does not match
怎么确认镜像真的在用
别信“命令执行完了”，-vvv 是唯一证据。运行 composer install -vvv 2>&1 | grep "Downloading"，盯紧 URL 域名：
- 出现
mirrors.aliyun.com或mirrors.tuna.tsinghua.edu.cn→ 镜像已生效 - 卡在
Resolving dependencies→ 和镜像无关，是本地 PHP 内存不足、xdebug 开着、或composer.json里写了"*"这类宽泛约束 - 临时绕过所有配置验证：用
composer install --no-plugins --repository-url=https://mirrors.aliyun.com/composer/ -vvv，如果这时快了，就坐实是项目或全局配置被覆盖
换镜像后依然慢？先看这三件事
镜像只加速下载和元数据拉取，不解决以下问题：
-
Resolving dependencies卡住：收紧 PHP 版本约束（如"php": "^8.1"而非"php": ">=7.4"），删掉"minimum-stability": "dev" - 缓存路径在机械盘、WSL2 挂载卷或加密目录上：查当前路径
composer config --global cache-dir，强制迁移到 SSD：composer config -g cache-dir /mnt/ssd/composer-cache - xdebug 启用中：它会让依赖解析慢 5–10 倍，临时禁用：
php -d xdebug.mode=off $(which composer) install
最常被忽略的是：项目 composer.json 里显式写了 "repositories" 字段，它会直接覆盖全局镜像——哪怕你 config -g 写得再对，也白搭。
