直接执行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/即可全局生效，该命令自动写入用户级配置文件，优先级高于项目级配置，末尾斜杠不可省略，拼错键名或地址将导致静默失效。
直接执行这条命令就能生效
全局镜像配置只需一条命令，不需要改文件、不用装脚本、不依赖 PHP 扩展：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/。执行后立刻生效，下次 composer install 就走阿里云镜像——它写入的是当前用户家目录下的 ~/.composer/config.json（Windows 是 %USERPROFILE%\AppData\Roaming\Composer\config.json），Composer 启动时自动读取，优先级高于项目级配置。
常见错误现象：命令跑完没反应、composer install 还是卡在 Loading composer repositories —— 很可能是因为：
-
repo.packagist拼错成repos.packagist（多了一个s），会静默写入无效字段，查composer config -g repo.packagist返回空 - 用了已下线的地址，比如
https://packagist.phpcomposer.com，curl 会报Could not resolve host - 权限问题：Linux/macOS 下提示
Permission denied，说明~/.composer目录归属不是当前用户，运行chown -R $USER ~/.composer再试
验证是否真的生效了
别信“执行完就 OK”，一定要验证。最可靠的方式是运行：composer config -g repo.packagist，输出必须是镜像 URL，例如 https://mirrors.aliyun.com/composer/，而不是 https://packagist.org 或空行。
如果输出不对，说明配置没写进去，或者写到了别的用户配置里（比如你用 sudo 执行，但日常开发用的是普通用户）。
额外确认方式：
- 运行
composer diagnose，看输出里Repo.packagist.org这一行是否显示为你的镜像地址 - 临时加
--no-cache执行一次composer update --no-cache，观察网络请求是否发往镜像域名（如mirrors.aliyun.com）
项目级配置更适合团队协作
全局配置对所有项目生效，但 CI/CD 或多人协作时容易出问题——比如 GitHub Actions 默认不读全局配置，宝塔后台以 www 用户运行，跟你终端里的用户不是同一个。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
这时更稳妥的做法是进项目根目录，运行：composer config repo.packagist composer https://mirrors.aliyun.com/composer/。它会安全地向 composer.json 的 repositories 字段写入结构，不破坏已有配置。
注意几个细节：
- 如果
composer.json里已有"repositories": {}（空对象），命令能正常 merge；如果是"repositories": []（数组），会报错，得先手动改成对象 - 别手写
"packagist.org": false—— 这会彻底禁用官方源，一旦镜像同步延迟或临时不可用，composer install直接失败 - 改完建议删掉
vendor/和composer.lock，再跑composer install，否则旧 lock 文件里的 hash 可能和镜像元数据不匹配
换源或恢复官方源的正确姿势
想切腾讯云？执行：composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/，原配置会被覆盖，不用先 unset。
想恢复官方源？别手动删文件，用 Composer 自带命令：composer config -g --unset repos.packagist（注意是 repos.packagist，不是 repo.packagist，这里 key 名带 s）。
如果之前混用过两种写法（比如既用过 repo.packagist 又用过 repositories.packagist），建议先执行两次 unset：composer config -g --unset repo.packagist 和 composer config -g --unset repositories.packagist，再重配，避免冲突。
最后提醒一句：镜像地址末尾的斜杠 / 不能少，https://mirrors.aliyun.com/composer（缺斜杠）会 404，Composer 不报错但拉不到包——这种细节最容易被忽略，也最难排查。
