还原Composer镜像本质是配置源地址，关键用composer config -g repo.packagist覆盖为https://packagist.org并clear-cache；确认生效需查三层配置（环境变量>项目级>全局）且验证日志URL。
Composer 命令行还原镜像，本质是恢复 composer.json 中声明的依赖到本地 vendor/ 目录，关键不在于“镜像”本身，而在于让 composer install 或 composer update 从你配置的镜像源拉取包——镜像只是加速手段，还原动作由命令触发。
怎么确认当前用了哪个镜像源
Composer 不会自动记住你用过什么镜像；它只读取当前配置生效的源。最可靠的方式是查全局或项目级配置：
- 查全局镜像：
composer config -g repo.packagist（若返回{"url": "https://mirrors.aliyun.com/composer/"}说明已设阿里云镜像） - 查项目级镜像（优先级更高）：
composer config repo.packagist，在项目根目录下运行 - 如果两个都没输出，说明走的是官方源
https://packagist.org
注意：composer config 输出的是 JSON 对象，不是纯 URL；直接看 url 字段值即可。
还原依赖时如何强制走镜像源
只要镜像源已正确配置，composer install 和 composer update 都会自动使用它——不需要额外加参数。但容易出问题的点有：
-
composer install只按composer.lock还原，不改版本，也不检查源是否可用；如果 lock 文件里记录的是官方源的 hash，但你现在配了镜像，Composer 仍会尝试从镜像拉（只要镜像同步及时，一般没问题） -
composer update会重新解析依赖并生成新 lock，此时一定走你当前配置的镜像源 - 如果执行时报
Could not fetch https://mirrors.xxx/.../package.json，不是命令写错了，而是镜像暂时不可达或路径映射异常（比如某些私有包未被镜像收录）
临时切换镜像源做还原（不改配置）
不想永久修改配置？可以用 -g 或 --repository-url 临时指定：
composer install --repository-url=https://mirrors.aliyun.com/composer/
这个参数会覆盖所有已配置的源，包括 packagist.org 和自定义 repo，适合单次快速验证镜像可用性。但注意：
- 该方式不支持带认证的私有镜像（如需 token，得用
config配置） - 如果项目中定义了
repositories数组（比如加了 private package），--repository-url会完全忽略它们，可能导致依赖解析失败 - 执行完不会留下痕迹，下次还得加
还原失败后怎么快速定位是不是镜像问题
别急着删 vendor 或重装 Composer，先做三件事：
- 用
curl -I https://mirrors.aliyun.com/composer/packages.json（换成你实际用的镜像地址）看 HTTP 状态码是否为 200 - 运行
composer diagnose，它会检查网络、CA 证书、镜像连通性，并提示 warning - 加
-v参数重试，例如composer install -v，看具体卡在哪一步、请求的是哪个 URL
常见干扰项：公司代理拦截 HTTPS、DNS 污染导致镜像域名解析成错误 IP、PHP 的 openssl 扩展缺失导致无法校验证书——这些和镜像配置无关，但现象都是“还原卡住”或“404”。
