重置 Composer 镜像需同步清理缓存、检查项目级配置、排除环境变量干扰；实际请求优先级为环境变量 > 项目级 repositories > 全局 repo.packagist > 默认源；最可靠验证是 composer diagnose -v 显示访问 repo.packagist.org。
重置 Composer 镜像配置到初始状态，不是删掉 repo.packagist 就完事——必须同步清理缓存、检查项目级覆盖、排除环境变量干扰，否则 composer install 仍会从镜像站拉包。
确认当前生效的镜像来源
别只信 composer config -g repo.packagist 的输出。这个命令只查全局配置，而实际请求优先级是：环境变量 > 项目级 repositories > 全局 repo.packagist > 默认源。真实生效的可能是你完全没意识到的地方。
- 运行
composer config -g repo.packagist：若返回空或报错Key "repo.packagist" does not exist，说明全局没设 - 进项目目录，运行
composer config repo.packagist：看项目级是否覆盖 - 检查环境变量：
echo $COMPOSER_REPO_PACKAGIST（Linux/macOS）或echo %COMPOSER_REPO_PACKAGIST%（Windows） - 最可靠验证方式：
composer diagnose -v，末尾显示Checking https://repo.packagist.org/packages.json才算真正回到官方源
清除缓存是重置的关键一步
镜像损坏或配置变更后不清理缓存，Composer 会继续用旧的 packages.json 快照和中断的 ZIP 包，导致 Failed to extract、corrupted archive 或请求仍发往镜像域名。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 必须执行：
composer clear-cache，清空~/.composer/cache/下所有内容 - 验证是否清干净：
ls -la ~/.composer/cache/repo/应为空或只剩空目录 - 如果某包反复失败（如
guzzlehttp/guzzle），可手动删对应缓存：rm -rf ~/.composer/cache/files/guzzlehttp/guzzle - 临时跳过缓存测试：
composer install --no-cache
逐层清理镜像配置项
Composer 的镜像配置分散在三层，漏掉任何一层都可能导致“看似重置成功，实则还在走镜像”。
- 全局配置（影响所有项目）：
composer config -g --unset repo.packagist和composer config -g --unset repos.packagist都要执行——旧文档常混用单复数，两者可能并存 - 项目级配置（当前目录）：
composer config --unset repositories，或直接编辑composer.json删除整个"repositories"字段 - 环境变量（终端会话级）：
unset COMPOSER_REPO_PACKAGIST（Linux/macOS）或set COMPOSER_REPO_PACKAGIST=（Windows CMD） - 注意：Windows 用户若提示
Permission denied，很可能是杀毒软件锁了%APPDATA%\Roaming\Composer\config.json，需管理员权限运行终端
验证是否真回到 packagist.org
配置清理完不等于生效。Composer 会缓存元数据路径，且某些老项目模板（如早期 Laravel 脚手架）自带 "repositories": {"packagist.org": false}，这等于关掉默认源又没给替代源，结果是找不到包。
- 实测请求地址：
composer require monolog/monolog --no-install -vvv 2>&1 | grep "GET https"（Linux/macOS），观察日志里下载packages.json的 URL - 正确应为：
GET https://repo.packagist.org/packages.json，而非mirrors.aliyun.com或其他镜像域名 - 如果仍走镜像，但配置已清空，大概率是网络层劫持（如阿里云 DNS 重定向），此时需换网络环境或加 Hosts 绕过
- 不要依赖
composer show -p，它只显示配置逻辑，不反映真实 HTTP 请求路径
