Composer全局镜像配置失效的三大原因：一是repo.packagist误写为repos.packagist导致静默失败；二是漏掉type值“composer”使Composer 2.x回退官方源；三是URL末尾缺斜杠引发404。
composer config -g repo.packagist 命令总不生效？检查这三处
90% 的新手配不成功，不是网络问题，是命令写错关键点。执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 后没效果，大概率踩了下面任一坑：
-
repo.packagist写成repos.packagist（多一个 s）→ 静默失败，查composer config -g repo.packagist返回空 - 漏掉中间的
composer（即 type 值）→ Composer 2.x 会 fallback 到官方源，不报错但无效 - URL 少了末尾斜杠：
https://mirrors.aliyun.com/composer→ 拼出错误路径/composerpackages.json，返回 404
验证是否写入成功：直接运行 composer config -g repo.packagist，输出必须是类似 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 的完整 JSON 对象。
为什么全局配置在 CI 或宝塔里不生效？
全局配置（-g）只对当前登录用户有效。CI 流水线用 runner 用户、宝塔用 www 用户运行，它们根本读不到你本地 root 或普通用户的 ~/.composer/config.json。
团队协作或部署时更可靠的做法是项目级配置：
立即学习“PHP免费学习笔记（深入）”；
- 进项目根目录（含
composer.json），运行composer config repo.packagist composer https://mirrors.aliyun.com/composer/（注意去掉-g） - 该命令会自动在
composer.json顶层添加"repositories"字段，key 固定为"packagist"，不会覆盖已有私有源 - 改完必须删掉
vendor/和composer.lock，再跑composer install（不是update）
换镜像后 still stuck at “Resolving dependencies”？和镜像无关
镜像只加速下载阶段，不影响依赖解析。如果你发现 composer update 卡在 Resolving dependencies 几十秒甚至几分钟，基本可以确定是以下原因：
-
"php": "^7.4 || ^8.0"这类宽泛版本约束，让 Composer 尝试大量组合 - 用了太多
dev-main或未锁定版本的包（如"monolog/monolog": "dev-main"） -
require-dev里塞了过多工具（如 phpstan、php-cs-fixer 等），增加解析复杂度
此时换镜像毫无帮助，得优化 composer.json 的约束写法或升级到 Composer 2.9.6+（其依赖解析算法已优化）。
临时测试镜像或 CI 脚本怎么切？
不想动配置，又想验证某个镜像是否可用，或者写 CI 脚本时需确保环境隔离，就用临时参数：
-
composer install --repository-url=https://mirrors.aliyun.com/composer/→ 优先级最高，覆盖全局和项目配置 -
--repository-url只对install和update生效，require不支持该参数 - 别用已停用的地址，如
https://packagist.phpcomposer.com，会卡住并报Could not fetch ... packages.json
阿里云目前同步频率高、稳定性好，出问题概率最低；腾讯云、华为云、中科大镜像也可备选，但 URL 必须带 HTTPS 和尾部斜杠。
