换源没生效主因是命令写错或版本不匹配：漏掉composer类型声明、键名误写为repos.packagist（应为repo.packagist）、url末尾缺/；composer 2.2+须用repositories.packagist.org，且value必须是合法json字符串并以/结尾，配置后需clear-cache并用composer update -vvv验证真实请求域名。
换源没生效，90% 不是网络问题，而是命令写错或版本不匹配——漏掉 composer 类型声明、键名多写一个 s、URL 少末尾 /，三者任一都会静默失败。
composer config -g repo.packagist 为什么输出为空？
这是最常被忽略的“假成功”：命令看似执行了，但 composer config -g repo.packagist 查出来是空或 null，说明根本没写进有效配置项。
-
repos.packagist（复数）是无效键名，Composer 内部只认repo.packagist（单数），写错就存进垃圾字段 - 漏掉中间那个
composer参数，比如写成composer config -g repo.packagist https://mirrors.aliyun.com/composer/，新版会 fallback 到默认源 - Windows 下 Git Bash 可能读的是
%APPDATA%\Composer\config.json，而 CMD 验证时却查~/.composer/config.json，路径不一致导致误判
Composer 2.2+ 必须用 repositories.packagist.org
如果你用的是 composer --version ≥ 2.2 的版本（当前主流 Docker 镜像、CI 环境基本都是），旧键名 repo.packagist 会被静默忽略——不是报错，是彻底不读。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 正确写法：
composer config -g repositories.packagist.org '{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}' - 注意 value 必须是合法 JSON 字符串：外层单引号包裹，内部双引号保留，
url结尾必须有/ - 验证是否真写入：
composer config -g repositories.packagist.org，输出应为完整 JSON 对象，不是空也不是报错 - 恢复默认：
composer config -g --unset repositories.packagist.org
项目级配置覆盖全局，且更可靠
只要项目根目录下的 composer.json 里存在 "repositories" 字段（哪怕只是 {} 或 {"packagist.org": false}），全局配置就完全失效。
- 安全写法：进项目目录，运行
composer config repo.packagist composer https://mirrors.ustc.edu.cn/composer/（不加-g） - 它会自动合并进
composer.json的"repositories"对象，不会覆盖已有私有源 - 前提是原
"repositories"是对象（如"repositories": {}），不是数组；如果是数组，命令会失败，需先手动转成对象 - 提交 Git 后，队友拉下来直接生效，
composer.lockhash 一致，CI 构建稳定
换源后还是卡在 packagist.org 或报 404？
元数据可能走了镜像，但 dist 包（zip/tar）仍从 GitHub 或官方源下载——这时清缓存、删 vendor、盯日志比重配源更重要。
- 必须执行：
composer clear-cache，否则本地索引还指向旧地址 - 验证真实请求域名：
composer update -vvv，盯住日志里Downloading http://开头的 URL，得是镜像域名（如mirrors.aliyun.com） - 删掉项目中任何硬编码的
"dist-url"字段，它会强制覆盖镜像的 dist 映射 - URL 少个
/就拼出错误路径，比如https://mirrors.aliyun.com/composer/packages.json→https://mirrors.aliyun.com/composerpackages.json，直接 404
真正容易被忽略的点是：换源不是一次配置就完事，它和缓存、composer.json 结构、dist 映射、甚至系统 CA 证书都耦合在一起。尤其在 CI 或内网环境，curl -I https://mirrors.aliyun.com/composer/ 返回 200 才算通，否则连请求都没发出去。
