改镜像源不生效主因是键名错（应为repo.packagist而非repos.packagist）、漏写type值“composer”、URL缺末尾斜杠，三者任一出错均静默失效；验证须查配置、diagnose及-vvv日志。
改镜像源不生效，90% 是因为 repo.packagist 键名写错、composer 类型值漏掉，或 URL 缺末尾 / —— 这三处任一出错，Composer 都静默忽略，不报错也不警告。
为什么 composer config -g repo.packagist 看似执行成功却没用
不是命令输错了，是 Composer 读配置时根本没识别到你写的字段。常见原因有：
-
repos.packagist（多了一个s）：官方只认repo.packagist（单数），写成复数会被当成无效键，存进配置文件但完全不加载 - 漏掉
composer类型值：完整命令必须是composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，省略中间的composer，新版会 fallback 到默认源 - URL 末尾没
/：比如写成https://mirrors.aliyun.com/composer，Composer 2.5+ 会拼出.../composerpackages.json导致 404；部分旧版则报Invalid repository type - Windows 下 Git Bash 没读对路径：实际配置写入的是
%APPDATA%\Composer\config.json，但你手动查的是~/.composer/config.json，自然查不到
全局换源该用 repo.packagist 还是 repositories.packagist.org
取决于你用的 Composer 版本，但不必纠结，直接按兼容性写法最稳：
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- Composer 1.x 和绝大多数 2.x（≤2.5）都支持
repo.packagist，推荐优先用它，命令简短不易错 -
repositories.packagist.org是 2.2+ 新增的“更规范”写法，但要求传入完整 JSON：composer config -g repositories.packagist.org '{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}'，引号和结构稍麻烦 - 两者不能共存：如果已设了
repositories.packagist.org，再跑repo.packagist命令不会覆盖，得先--unset清掉 - 验证是否生效，统一用
composer config -g repo.packagist查——有输出即表示被识别，空或报错说明没写对
项目级配置比全局更可靠，但要注意写法细节
当你在团队协作、CI 流水线或私有包环境中工作时，项目级配置才是首选，因为它可 Git 跟踪、行为一致、不污染全局环境：
- 进项目根目录后运行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（注意去掉-g），它会自动在composer.json里写入"repositories": {"packagist": {...}}，不覆盖已有私有源 - 别手动编辑
composer.json的repositories数组：顺序错、格式错、多加逗号，都可能让 Composer 解析失败或 fallback 到官方源 - 如果项目原本就有
"repositories": []或"repositories": {"packagist.org": false}，那全局设置完全失效，必须先删掉或改写这个字段 - 项目级配置生效后，
composer config repo.packagist会输出镜像地址；而composer config -g repo.packagist可能为空，这是正常现象
换源后怎么确认真的在用镜像，而不是“看起来生效了”
别信命令回显，要看到真实请求发到了镜像域名上才算数。三步验证缺一不可：
- 查配置：
composer config -g repo.packagist输出必须是带type和url的 JSON，比如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} - 看诊断：
composer diagnose输出中 “Repo packagist.org:” 后面的域名必须是mirrors.aliyun.com或对应镜像域名 - 抓日志：
composer update -vvv运行时，搜索Downloading行，URL 必须含mirrors.aliyun.com或你配的镜像域名；如果看到packagist.org或github.com，说明 dist 包仍走官方，需检查是否误配了dist-url字段
最容易被忽略的是缓存：哪怕配置全对，不执行 composer clear-cache，本地元数据还是从旧源加载，install 依旧慢、依旧超时。
