答案是：必须严格满足三要素——键名repo.packagist（单数小写）、type值为composer、URL以/结尾，缺一则静默失效；验证需执行composer config -g repo.packagist，输出应为{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。
composer config -g repo.packagist 命令必须写对三要素
配了镜像却还是慢，90% 是这条命令没写对——它不报错，但静默失效。关键就三个点：repo.packagist（单数、小写、不能多 s）、中间的 composer（这是 type 值，不是可选参数）、URL 必须是 https://mirrors.aliyun.com/composer/ 这种带末尾斜杠的形式。
常见错误包括：
- 写成
repos.packagist或packagist.org→ 键名错，配置不落盘 - 漏掉
composer→ Composer 2.0+ 会 fallback 回官方源，日志里仍显示packagist.org - URL 少斜杠，比如
https://mirrors.aliyun.com/composer→ 拼出/composerpackages.json导致 404，下载失败但提示模糊 - 没加
-g→ 只改当前项目composer.json，换目录就失效
验证是否生效只看 composer config -g repo.packagist 输出
别信“我刚敲过命令”，真正生效与否，只认这一条命令的输出结果。运行 composer config -g repo.packagist，你应该看到类似：
{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
如果输出为空、null、"https://packagist.org"，或者报 Key "repo.packagist" does not exist，说明根本没写进去。Windows 用户尤其要注意：%USERPROFILE%\AppData\Roaming\Composer\config.json 可能被系统保护，权限不足时命令看似成功，实则没写入。
立即学习“PHP免费学习笔记（深入）”；
顺手清缓存再试：composer clear-cache，否则旧包还走缓存路径，验证失真。
项目级配置比全局更可靠，尤其在 CI 和团队协作中
全局配置在本地开发很省事，但在 CI 流水线或宝塔、Docker 环境里常失效——因为 -g 写的是当前用户家目录，而 runner、www-data 等用户根本读不到你的配置。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
进项目根目录后执行：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/
这条命令会自动在 composer.json 顶层写入 "repositories" 字段，key 固定为 "packagist"，且不会覆盖已有私有源（前提是原 repositories 是对象结构）。如果项目已有 repositories 数组，别手动覆盖，用命令追加更安全。
改完必须删掉 vendor/ 和 composer.lock，再跑 composer install —— 否则 lock 文件里还记着旧源地址，根本不会走新镜像。
换源后仍卡在 Resolving dependencies？和镜像完全无关
镜像只加速下载环节，不解决依赖解析慢的问题。composer update 卡在 Resolving dependencies 几十秒以上，基本可以排除网络因素。真凶通常是：
-
"php": "^7.4 || ^8.0"这类宽泛版本约束，让 Composer 要遍历大量候选版本 -
require-dev里塞了太多未锁定的工具链（如phpunit/phpunit、friendsofphp/php-cs-fixer） - Xdebug 开着 —— 它会让依赖解析慢 5 倍以上，PHPStorm 默认开启
- 项目启用了已废弃的
fxp/composer-asset-plugin，它绕过 Composer 镜像，直连 Bower/NPM 源
这类问题换任何镜像都无效，得收紧约束、拆分 dev 包、关 Xdebug、或升级到现代替代方案（如 npm-asset-packagist.org）。
最容易被忽略的点：镜像 URL 的末尾斜杠、repo.packagist 的拼写、以及 composer clear-cache 是否真执行了——这三件事做错任意一个，你就还在原地等 packagist.org 超时。
