确认是缓存zip损坏而非网络问题：看到“failed to extract”“corrupted zip file”或“extracting vendor/xxx”后报错，基本可断定是~/.composer/cache/files/下特定zip损坏；此时composer install -v末尾显示的extracting路径即为损坏文件位置，非dns、代理或镜像连通性问题。
怎么确认是缓存 ZIP 损坏而不是网络问题
看到 Failed to extract、Corrupted zip file 或 Extracting vendor/symfony/console 后直接报错，基本可以断定是 ~/.composer/cache/files/ 下某个 ZIP 文件损坏，不是连不上镜像，也不是 DNS 或代理问题。Composer 会拿着这个坏 ZIP 去解压，校验失败就卡住，不会自动重试或跳过。
关键判断依据：composer install -v 输出末尾紧挨着 Extracting 或 Downloading 的那行路径，比如：
Downloading https://mirrors.aliyun.com/composer/dists/monolog/monolog/2.9.0.0/monolog-monolog-2.9.0.0-zip-d1a3f.zip Extracting /home/user/.composer/cache/files/monolog/monolog/monolog-monolog-2.9.0.0-zip-d1a3f.zip
这行里的 ZIP 路径就是你要盯死的目标。
如何精准定位并删除损坏的 ZIP 文件
别一上来就 composer clear-cache——它会删掉所有包，但 Composer 后续仍可能复用已损坏的缓存副本（只校验哈希，不重新下载），结果还是失败。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 查缓存根目录：
composer config --global cache-dir（Linux/macOS 通常是~/.composer/cache，Windows 是%APPDATA%\Composer\Cache） - 进
files/子目录，按包名模糊搜索：ls -l *monolog*2.9.0*（Linux/macOS）或 PowerShell 中：Get-ChildItem "$env:APPDATA\Composer\Cache\Files" -Recurse -Filter "*monolog*2.9.0*.zip" - 只删匹配的那个 ZIP，别碰
repo/和vcs/目录——它们不参与解压流程
删 ZIP 后还报错？必须同步清理 lock 和 vendor
删完 ZIP 还出错，大概率是 composer.lock 里硬编码的 dist.sha256 值和当前缓存不匹配。Composer 拒绝安装，不是因为 ZIP 坏了，而是“你给的哈希对不上我手上的文件”。
- 备份：
cp composer.lock composer.lock.bak - 删干净：
rm -rf vendor composer.lock（Windows 用rd /s /q vendor & del composer.lock） - 重装加双重保险：
composer install --no-cache --force-checksums：--no-cache强制跳过本地 ZIP，--force-checksums让校验失败立刻退出，不污染vendor/
为什么不能只删 vendor 不动 lock
如果 vendor/ 是空的、vendor/autoload.php 不存在、或者 vendor/composer/installed.json 是零字节或 JSON 截断，只删 vendor/ 留着 composer.lock 就没用——composer install 会尝试从 lock 重建，但解压环节照样卡在坏包上。
CI 环境尤其要小心：composer.lock 若含旧源地址（比如还写着 packagist.org），哪怕你全局配了阿里云镜像，重装也永远走错路。删 lock 是绕不过去的一步。
