不生效是因为键名必须为repo.packagist、type值必须显式写composer、URL必须以https://开头且末尾带斜杠，三者缺一即静默回退官方源；验证需输出完整JSON对象。
composer config -g repo.packagist 命令不生效？检查三个硬性条件
命令跑完没反应、composer install 依然卡在 Loading composer repositories，大概率不是网络问题，而是配置写错了。Composer 2.x 对键名、type 和 URL 格式有严格要求，任一缺失就静默 fallback 到官方源，不报错也不提示。
-
repo.packagist是唯一合法键名——写成repos.packagist、packagist.org或repositories.packagist全无效 - 中间的
composer是type值，不是可选参数，也不能省略或替换成其他字符串 - URL 必须是 HTTPS 且末尾带
/：https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（少斜杠会拼出/composerpackages.json导致 404）
验证是否写入成功：运行 composer config -g repo.packagist，输出必须是完整 JSON 对象，例如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null、报 Key not found，说明根本没写进去。
阿里云、腾讯云、华为云镜像怎么选？地址和细节差异
主流镜像中，阿里云同步最及时、稳定性最高，推荐作为默认首选；腾讯云响应快但偶有 CDN 缓存延迟；华为云托管在 OBS 上，新包同步可能慢 5–15 分钟。三者地址格式不同，容易踩坑：
- 阿里云：
https://mirrors.aliyun.com/composer/（必须带末尾/） - 腾讯云：
https://mirrors.cloud.tencent.com/composer/（也必须带/） - 华为云：
https://mirrors.huaweicloud.com/repository/php（末尾不带/，但composer config会自动补全，不影响使用）
注意：https://packagist.phpcomposer.com 已停用，curl 会返回 Could not resolve host；HTTP 地址（如 http://...）在 Composer 2.0+ 中被直接拒绝，不能用。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
全局配置 vs 项目级配置：谁在真正生效？
全局配置（加 -g）只对当前 shell 用户生效，CI/CD（GitHub Actions）、宝塔面板（www 用户）、Docker 容器里基本读不到它。项目级配置写进 composer.json 的 repositories 字段，才能保证协作一致。
- 全局配置适合个人开发机：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 项目级配置进项目根目录执行：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉-g） - 项目已有
"repositories": []数组时，该命令会报错；需先手动改为对象格式"repositories": {}再重试 - 切勿写
"packagist": false，这会导致基础扩展（如ext-json）校验失败
改完必须删掉 vendor/ 和 composer.lock，再执行 composer install（不是 update），否则旧 lock 文件仍指向海外源。
换源后还是卡住？清缓存和确认执行用户才是关键
镜像只加速下载，不解决依赖解析慢或 PHP 环境崩溃问题。常见卡点和对应动作：
-
composer install卡在Loading composer repositories：先composer clear-cache，再删vendor/和composer.lock - 宝塔面板里卡住：检查 PHP CLI 是否禁用了
putenv、proc_open、pcntl_signal—— 进「PHP 管理」→「禁用函数」页签删掉它们 - CI 流水线或 www 用户下不生效：用
sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/显式切换用户配置 - 某些企业网络拦截 HTTPS：临时测试可用
http://mirrors.aliyun.com/composer/，但不可长期用
最易忽略的是：镜像配置生效 ≠ 依赖解析变快。如果卡在 Resolving dependencies，和镜像完全无关，得看 composer.json 里的版本约束是否太宽、require-dev 是否塞了太多工具包。
