镜像损坏本质是缓存污染而非配置错误，必须执行composer clear-cache清除损坏的元数据和中断zip，再用composer config -g repo.packagist composer https://packagist.org强制覆盖全局源，二者缺一不可。

镜像损坏不是配置文件出错，而是缓存里存了坏的元数据或中断下载的压缩包——composer clear-cache + composer config -g repo.packagist composer https://packagist.org 这两条命令组合，才是真·一键重置。

报“corrupted archive”或“Failed to extract”时该怎么做

这类错误几乎全是 ~/.composer/cache/files/ 下某个 .zip 文件写了一半就断了，解压直接失败。别急着删 vendor/，它不解决根源：

• 先运行 composer clear-cache，清掉损坏的压缩包和残留元数据
• 再试 composer install —— 大概率立刻通过
• 如果还报错，加 --no-cache 强制跳过所有缓存：composer install --no-cache
• 只某一个包反复失败（比如 guzzlehttp/guzzle），可手动删对应缓存路径：rm -rf ~/.composer/cache/files/guzzlehttp/guzzle

换镜像后还是从 repo.packagist.org 拉包？

这不是网络问题，是 ~/.composer/cache/repo/ 里还躺着旧镜像的 packages.json 快照。Composer 会照着老快照找包，哪怕你已执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，它也照样 404。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

• 必须运行 composer clear-cache，否则新镜像配置等于没生效
• 验证是否清干净：ls -la ~/.composer/cache/repo/ 应为空或只剩空目录
• 再跑 composer show -p | head -3，第一行 URL 必须是 https://repo.packagist.org/packages.json，不是镜像域名

为什么 composer config -g --unset repos.packagist 常常失效

这个命令在 Composer 2.2–2.4 小版本中 fallback 逻辑有缺陷，删完字段可能卡住或报 Could not parse version constraint；更关键的是，字段名本身已弃用：

• 正确键名是 repo.packagist（单数），不是 repos.packagist（复数）
• 写错字段名不会报错，但配置无效，你根本看不到效果
• 删掉字段 ≠ 自动回退到官方源，尤其当项目 composer.json 里还有 "repositories" 块时，它会彻底屏蔽全局设置
• 真正稳的做法是覆盖：composer config -g repo.packagist composer https://packagist.org

重置后仍走镜像站？检查三层覆盖关系

Composer 查源顺序是：环境变量 > 项目级配置 > 全局配置。哪怕你全局设对了，只要当前项目 composer.json 里有 "repositories" 字段，它就优先生效。

• 查项目是否自定义源：grep -A 5 '"repositories"' composer.json
• 查当前实际生效源：composer config repo.packagist（不带 -g），输出不是 https://packagist.org 就说明被盖掉了
• 临时覆盖项目级设置：composer config repo.packagist composer https://packagist.org（进项目目录后运行）
• 极端情况检查环境变量：env | grep COMPOSER_REPO，有就 unset COMPOSER_REPO_PACKAGIST

缓存不清理，配置改得再准也白搭；项目级 repositories 不清理，全局命令就是摆设。真正的“一键”，是 clear-cache 和 config -g repo.packagist 同时执行，再加一次 show -p 看真实 URL —— 别信命令没报错，要看它到底连了哪个地址。