彻底清除 composer 镜像配置需分三步：先执行composer config --global --unset repositories删除全局仓库，再运行composer config --global repo.packagist '{"type":"composer","url":"https://packagist.org"}'显式恢复官方源，最后用composer install -vvv | grep -i 'packagist\.org'验证请求是否真正指向官方域名。
如何彻底清除 Composer 的镜像配置
Composer 的镜像（如阿里云、腾讯云、华为云等）是通过修改 composer.json 或全局配置 config.json 生效的，重置不是“一键还原”，而是要定位并删除对应配置项。最常见误操作是只改了项目级 composer.json 却忽略全局配置，导致看似清除了镜像，实际仍走代理。
关键路径有两处：
- 项目级：
./composer.json中的repositories字段（可能含packagist.org覆盖） - 全局级：
~/.composer/config.json（Linux/macOS）或%APPDATA%Composerconfig.json（Windows）中的repositories或repo.packagist
执行以下命令可直接查看当前生效的全局配置来源和内容：
composer config --global --list
若输出中包含 repositories 相关行，说明镜像未清干净。
用 composer config 删除镜像配置的正确方式
composer config 支持按 key 删除，但必须指定作用域（--global 或项目内），且不能只删 repositories 数组里的某一项——它不支持嵌套路径删除。所以得用“覆盖为默认值”的方式还原。
还原 packagist 官方源（即取消镜像）的实操步骤：
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 删除全局自定义仓库：运行
composer config --global --unset repositories - 显式恢复 packagist.org 为默认源：运行
composer config --global repo.packagist '{"type": "composer", "url": "https://packagist.org"}' - 检查是否生效：运行
composer config --global repo.packagist，应输出完整 JSON 对象，而非null或空值
⚠️ 注意：repo.packagist 是特殊键名，不是 repositories.packagist；写错会导致配置残留或报错 Invalid repository type。
为什么 composer clear-cache 不能重置镜像
composer clear-cache 只清下载缓存（~/.composer/cache），不影响任何配置逻辑。镜像行为由配置驱动，缓存清不清理，只要 config.json 还写着阿里云地址，下次 install 就依然走镜像。
容易混淆的点：
- 执行
clear-cache后首次update会变慢——这是因重新拉取元数据，不是镜像失效 - 如果镜像服务器已下线（如旧版腾讯云镜像），错误信息通常是
Could not fetch https://mirrors.cloud.tencent.com/.../packages.json，此时必须删配置，而非清缓存 - 某些 IDE（如 PhpStorm）会缓存 Composer 配置，修改后需重启终端或 IDE 才能识别新配置
验证镜像是否真正还原
最可靠的验证不是看命令输出，而是观察网络请求行为。在终端开启调试模式运行一次安装：
composer install -vvv 2>&1 | grep -i 'packagist.org|mirrors.'
若输出中出现 GET https://packagist.org/packages.json 且无其他镜像域名，则还原成功。如果仍看到 mirrors.aliyun.com 等字样，说明还有某处配置没清理干净——大概率是项目根目录下的 composer.json 里还留着 "repositories" 块。
复杂点在于：Composer 会合并项目级与全局配置，项目级配置优先级更高。哪怕全局已还原，只要项目 composer.json 里有一行 "repositories": [{"type": "composer", "url": "https://mirrors.aliyun.com/php/"}]，就仍然走镜像。
