composer config -g repo.packagist 命令总不生效的根本原因是未同时满足三个硬性条件：键名必须为 repo.packagist（单数小写，不能多s）、type 值必须显式传入 composer、URL 必须是 HTTPS 且末尾带 /；缺一即静默失效，不报错也不写入配置。
composer config -g repo.packagist 命令为什么总不生效
不是网络卡，是三个硬性条件缺一不可：键名必须是 repo.packagist（单数、小写、没s），composer 必须作为 type 值显式传入，URL 必须是 HTTPS 且末尾带 /。漏掉任意一个，命令就静默失败——不报错、不提示、也不写入配置。
常见错误写法：
-
composer config -g repos.packagist composer https://mirrors.aliyun.com/composer/→ 键名多了一个s，写进无效字段 -
composer config -g repo.packagist https://mirrors.aliyun.com/composer/→ 缺composer类型，fallback 到官方源 -
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、或含 packagist.org 字样，都说明没配对。
全局镜像被项目级配置覆盖却不报错
项目根目录下 composer.json 中的 repositories 字段优先级永远高于全局 repo.packagist。哪怕你刚配好阿里云镜像，只要 composer.json 里有 "repositories": [] 或旧的失效 URL，Composer 就会直接用它，且完全不提醒你。
典型误判场景：
- 团队协作时，有人手动编辑了
repositories数组但忘了删掉旧的packagist.org条目 - CI 流水线以
www-data用户运行，而-g配的是开发者本地用户，根本没加载 - 项目已存在私有源，但
repositories是数组结构，新镜像没追加进去，反而被忽略
推荐做法：进项目根目录，运行composer config repo.packagist composer https://mirrors.aliyun.com/composer/
它会自动在 composer.json 顶层写入 "repositories": {"packagist": {...}}，不覆盖已有私有源——前提是原 repositories 是对象而非数组。
换源后仍卡在 “Loading composer repositories”
这说明镜像根本没被用上。Composer 会优先读取本地缓存和 composer.lock 中记录的原始元数据地址，哪怕你已改配置，它也可能还在发请求到 packagist.org。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
必须按顺序操作：
- 先运行
composer clear-cache - 删掉项目下的
vendor/和composer.lock - 再执行
composer install -vvv
观察日志里真实请求的域名：出现 mirrors.aliyun.com 或 mirrors.tuna.tsinghua.edu.cn 才算真正走镜像；如果还看到 packagist.org，说明清理不到位或配置未命中。
APT 安装的 Composer 为什么一定不能用
Ubuntu 官方源里的 php-composer 包长期卡在 2.2.22，它不支持 PHP 8.3+ 的 autoloader 行为，也解析不了 ^2.5 这类依赖约束。更关键的是：/usr/share/php/composer/composer 路径不可写，self-update 永远报 Permission denied；它还不自动加入 $PATH，装完可能连 composer --version 都找不到命令。
必须用官方脚本安装：
- 校验
SHA384签名（跳过 = 交出整个 PHP 生态信任链） - 确保启用
zip、phar、mbstring、xml、curl扩展（composer --version成功 ≠ 环境就绪） - 安装路径设为
/usr/local/bin，并确认该路径在$PATH中
验证：运行 composer --version 应输出类似 Composer version 2.9.6 —— 这才是当前稳定可用的版本。
