“failed to extract vendor/package”表示zip包本身损坏，非网络中断所致，需彻底清缓存、删vendor、删composer.lock（谨慎）、加--no-cache重装四步齐备方可解决。
Failed to extract vendor/package 错误说明什么
这表示 Composer 解压某个 ZIP 包时失败，不是网络中断，而是缓存里那个 .zip 文件本身已损坏——比如下载一半被杀、磁盘写入异常、镜像源同步滞后导致校验哈希不匹配。它和 corrupted archive、zlib_decode() error 属同一类问题，直接删 vendor/ 或重跑 composer install 都没用。
清缓存后仍报错？确认三件事
运行 composer clear-cache 只是第一步，必须验证是否真正生效：
Discussion 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，进该目录确认files/和downloads/子目录为空 - 重装时加
-v参数：日志里必须出现Downloading，而不是Using cache或Extracting archive - 若只针对某包反复出错（如
monolog/monolog），可手动删对应缓存子目录：rm -rf $(composer config --global cache-dir)/files/monolog/monolog
强制重装必须四步齐备
缺一不可，否则仍是“假重装”：
- 删
vendor目录：rm -rf vendor（Windows 用rmdir /s vendor） - 删
composer.lock：rm composer.lock（删前确保已提交 Git，否则线上环境版本可能漂移） - 清全局缓存：
composer clear-cache（输出含Clearing cache (all)才算成功） - 带参数重装：
composer install --no-cache --prefer-dist --no-dev（--no-cache是关键，它禁用本次所有缓存查找逻辑）
CI/CD 中容易被忽略的缓存陷阱
流水线里常挂载持久化 ~/.composer/cache，光靠 --no-cache 不保险：
- 用环境变量彻底绕过：
COMPOSER_CACHE_DIR=/dev/null composer install --no-cache - 或动态创建临时缓存目录：
COMPOSER_CACHE_DIR=$(mktemp -d) composer install - 私有仓库凭据、
repositories配置不会被clear-cache清除，切镜像后务必确认composer config repo.packagist输出的是新地址
