Composer镜像配置不生效的主因是命令错误：键名必须为repo.packagist（单数）、type值必填composer、URL末尾须带/，三者缺一即静默回退至packagist.org；验证需同时满足config输出标准JSON及install -vvv日志显示镜像路径。
不是网络差，是根本没走镜像——90% 的“部署慢”问题，都卡在 composer config 命令写错三个地方。
为什么 composer config -g repo.packagist 总是不生效？
命令看似跑成功了，但 composer install 依然卡在 Downloading from https://packagist.org，本质是配置静默失败：Composer 不报错、不提示，直接 fallback 到默认源。
-
repo.packagist写成repos.packagist（多一个s）→ 键名非法，完全忽略 - 漏掉中间的
composer类型值 → 命令变成composer config -g repo.packagist https://mirrors.aliyun.com/composer/，Composer 2.x 会当作无效配置丢弃 -
URL少了末尾斜杠/→ 拼出https://mirrors.aliyun.com/composer//p2/monolog/monolog.json这类路径，返回 404，请求直接失败
验证是否真写进去了：composer config -g repo.packagist 必须输出完整 JSON，形如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null、或只返回字符串，说明没配进去。
项目级配置比全局更可靠，尤其在 CI/CD 中
全局配置（-g）在 Docker 容器、宝塔面板、GitLab Runner 等场景下极易失效：基础镜像可能没初始化 ~/.config/composer/ 目录；执行用户（如 www）读不到 root 的配置。
立即学习“PHP免费学习笔记（深入）”；
- 进项目根目录，运行：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加-g） - 该命令自动向
composer.json的repositories字段追加"packagist"条目，不覆盖已有私有源 - 拉代码即生效，CI 构建时无需额外 setup，行为确定
别手动编辑 composer.json：JSON 格式错一个逗号，composer install 就直接报错退出。
换源后仍卡在 Resolving dependencies 或报 hash does not match？
镜像只加速下载，不解决依赖解析卡顿，也不兼容旧缓存。
-
Resolving dependencies卡住 → 和镜像无关，典型原因是composer.json里写了过宽的 PHP 版本约束（如"php": "^7.4 || ^8.0 || ^8.1 || ^8.2"），或"minimum-stability": "dev"导致候选版本爆炸 -
hash does not match→ 旧composer.lock记录的是 packagist.org 的包哈希，和镜像返回的元数据不一致，必须删掉vendor/和composer.lock重来 - 换源后第一遍务必加
--no-cache：composer install --no-cache --no-dev --prefer-dist --optimize-autoloader --no-interaction
不清理缓存，Composer 会优先读旧元数据并尝试从 packagist.org 校验，结果就是卡在 DNS 或 TLS 握手——你根本看不到镜像域名出现在日志里。
怎么确认请求真打到了镜像？别信 config 输出
composer config -g repo.packagist 显示 URL 正确，不代表网络请求就走了它。必须实测日志：
- 运行：
composer show monolog/monolog -vvv 2>&1 | grep "Downloading" - 日志里必须出现
mirrors.aliyun.com或mirrors.cloud.tencent.com等镜像域名 - 如果看到
https://packagist.org或repo.packagist.org，说明 fallback 触发了，配置没起作用
腾讯云镜像（https://mirrors.cloud.tencent.com/composer/）目前最稳，HTTPS + 全量同步 + 无认证要求；阿里云镜像（https://mirrors.aliyun.com/composer/）响应快，适合通用场景；华为云镜像（https://repo.huaweicloud.com/repository/php/）在华南节点表现突出——选哪个，建议用 curl -o /dev/null -s -w "%{time_total}\n" https://xxx/packages.json 实测对比。
