根本原因是键名必须为单数repo.packagist、type值必须显式填composer、url须以https://开头且末尾带/；任一缺失均静默回退至packagist.org。
composer config -g repo.packagist 为什么总不生效
根本原因就三条：键名必须是 repo.packagist（单数、全小写），type 值必须显式写成 composer，url 必须以 https:// 开头且末尾带 /。三者缺一，Composer 2.2+ 就会静默 fallback 到 https://packagist.org，不报错也不提示。
常见错误示例：
-
composer config -g repos.packagist composer https://mirrors.aliyun.com/composer/→ 键名多一个s，写进去了但不认 -
composer config -g repo.packagist https://mirrors.aliyun.com/composer/→ 漏掉composer，直接走官方源 -
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer→ 缺末尾/，拼出/composerpackages.json导致 404
验证是否成功：必须运行 composer config -g repo.packagist，输出得是完整 JSON，比如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null、或只返回字符串都说明没写进去。
项目级配置比全局更可靠，怎么安全追加
全局配置看着省事，但一进公司项目或开源协作就容易出问题：CI 流水线 hash 不一致、新人拉代码行为不统一、私有包源被覆盖。推荐在项目根目录执行（去掉 -g）：
立即学习“PHP免费学习笔记（深入）”；
composer config repo.packagist composer https://mirrors.aliyun.com/composer/
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
这条命令会自动在 composer.json 顶层写入 "repositories" 字段，且 key 固定为 "packagist"，不会覆盖已有配置——前提是原 repositories 是对象格式（{}），不是数组（[]）。
如果项目已有私有源，别手动编辑 composer.json，否则易误删；用命令追加更安全。若原 repositories 是数组，需先手动改为空对象再执行该命令。
换镜像后依然卡在 Resolving dependencies？和镜像无关
镜像只加速包下载（Downloading 阶段），不解决依赖解析（Resolving dependencies）慢的问题。如果你发现 composer update 卡住几十秒甚至几分钟，基本可以排除镜像问题，重点排查以下几点：
-
"php": "^7.4 || ^8.0"这类宽泛版本约束，会让 Composer 尝试大量组合 -
require-dev里塞了太多未锁定版本的工具链（如"phpunit/phpunit": "^9"） - 项目中存在大量
dev-分支依赖，或未固定composer.lock
这类问题换任何镜像都没用；临时解法是删掉 vendor 和 composer.lock，再 composer install——但治标不治本，建议收紧版本约束。
阿里云镜像地址必须带末尾斜杠，中科大可作备选
当前可用且同步及时的镜像源中，阿里云和中科大已全量同步 packagist，延迟极低。但要注意：
- 阿里云地址必须是
https://mirrors.aliyun.com/composer/（末尾/不可省） - 中科大镜像可作为备选：
composer config -g repo.packagist composer https://mirrors.ustc.edu.cn/composer/ - 别用已下线的旧地址，如
https://packagist.phpcomposer.com（2023 年已关停） - PHPStudy 8.1+ 用户可直接在图形界面选择阿里云镜像，无需命令行操作
最常被忽略的是：哪怕你用 PHPStudy 一键安装了 Composer，它默认也不配镜像——这一步必须手动补上，否则第一次 composer install 会卡在 Loading composer repositories 超 5 分钟，且不报错。
