还原 composer 镜像为官方源需执行 composer config --global --unset repos.packagist 等命令清除全局配置，检查并删除项目级 repositories 和环境变量 composer_repo_packagist，再运行 composer clear-cache 并通过 composer diagnose 验证 repo packagist.org: ok。
如何还原 Composer 镜像为官方源
Composer 默认使用 packagist.org，国内用户常手动设为阿里云、腾讯云等镜像源，但升级失败、包签名异常或调试依赖问题时，必须切回官方源。关键不是“删配置”，而是确保 composer.json 里没硬编码镜像，且全局配置被清除。
执行以下命令可彻底还原：
-
composer config --global --unset repos.packagist（移除自定义 packagist repo） -
composer config --global --unset repos.packagist.org（部分旧版镜像会写这个 key） -
composer config --global --unset repositories（慎用，会清空所有自定义仓库，仅当确认无其他私有源时用）
验证是否生效：composer config --global repos.packagist 应无输出；再运行 composer diagnose，看到 Repo.packagist.org: OK 即表示已回退到官方源。
清理 Composer 中残留的无效镜像配置
常见无效配置包括：已下线的镜像地址（如华为云早期镜像）、拼写错误的仓库名、重复添加导致的嵌套结构（如 "packagist": {"type": "composer", "url": "..."} 被多次写入），这些不会报错，但会让 composer update 变慢甚至卡住。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
定位方式：composer config --global -l 查看完整配置列表，重点关注 repos.* 和 repositories 下的条目；cat $(composer config --global home)/config.json 直接读原始文件更可靠。
- 逐个删除可疑项：
composer config --global --unset repos.xxx（xxx 是你看到的仓库别名） - 若
repositories是数组形式（含多个对象），无法用--unset精确删某一项，需手动编辑$(composer config --global home)/config.json，删掉对应 object 后保存 - 改完后务必运行
composer clear-cache，否则 Composer 可能仍用旧镜像的缓存元数据
为什么 composer self-update 不解决镜像问题
很多人误以为升级 Composer 就能重置源，其实 self-update 只更新二进制文件，完全不碰配置。即使升级到 2.7+，只要 config.json 里还留着 "packagist": {"url": "https://mirrors.aliyun.com/composer/"}，它就继续走镜像。
- Composer 2.2+ 开始支持
packagist.org自动 fallback，但前提是没显式覆盖repos.packagist - 某些镜像做了 CDN 调度，返回 404 或 503 时 Composer 不一定报错，只会静默跳过，导致依赖解析结果不一致
- 项目级
composer.json中的repositories优先级高于全局配置，记得检查项目根目录下是否有隐藏的镜像设置
清理后仍走镜像？检查环境变量和代理
即使清空了所有配置，composer install 还是访问镜像域名，大概率是环境变量或系统代理在干扰。
- 检查
COMPOSER_REPO_PACKAGIST环境变量：echo $COMPOSER_REPO_PACKAGIST，若非空则用unset COMPOSER_REPO_PACKAGIST清除 - 排查 HTTP 代理：
echo $HTTP_PROXY/$HTTPS_PROXY，某些公司网络会强制重定向 packagist.org 流量到内部镜像 - 临时绕过代理测试：
HTTPS_PROXY= composer update --no-plugins
最稳妥的验证方式：开一个全新终端（不加载 shell profile），cd 到空目录，运行 composer create-project --no-install phpunit/phpunit，抓包看实际请求的是 packagist.org 还是镜像域名。
