正确设置全局镜像源需执行两条命令：composer config -g repositories.packagist.org.type composer 和 composer config -g repositories.packagist.org.url https://mirrors.aliyun.com/composer/，缺一不可；旧命令 composer config --global repo.packagist 无效且报错。
composer config --global repo.packagist 是错的命令
这个命令根本不能设置全局镜像源，它会报错 Invalid repository type [packagist]。因为 repo.packagist 不是合法的配置项名，Composer 8.0+ 已废弃旧式写法，现在必须用 repositories.packagist.org 这个键名。
正确设置全局镜像源的命令
直接运行这一条命令即可生效（以阿里云镜像为例）：
composer config -g repositories.packagist.org.type composer
composer config -g repositories.packagist.org.url https://mirrors.aliyun.com/composer/
- 两个命令必须都执行，缺一不可：先声明类型为
composer，再指定 URL -
-g表示全局，作用于~/.composer/config.json，影响所有项目 - 如果之前手动改过
config.json，建议先删掉repositories下的旧 packagist 条目，避免冲突 - 执行后可运行
composer config -g repositories.packagist.org.url验证是否写入成功
为什么有些镜像源不生效？
常见失效原因不是命令输错，而是镜像服务本身策略变化或 Composer 版本兼容问题：
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 腾讯云镜像（
https://mirrors.cloud.tencent.com/composer/）从 2023 年底起要求 User-Agent，老版本 Composer（composer self-update 最新版可解决 - 华为云镜像（
https://mirrors.huaweicloud.com/repository/php/）路径末尾必须带/，少写会 404 - 某些公司内网镜像启用了私有证书，需额外配置
composer config -g cafile /path/to/cert.pem - 如果项目根目录存在
composer.json且定义了repositories，它会覆盖全局设置——这是设计行为，不是 bug
临时切换回官方源（调试用）
不需要删配置，只需临时禁用：
composer config -g repositories.packagist.org false
之后任何 composer require 或 install 都会回退到官方源。想恢复就再跑一遍前面的两行设置命令。
注意：全局镜像只影响 packagist.org 的包发现，不影响 VCS 类仓库（如 GitHub）、path 类本地仓库，也不影响 platform 配置。
