Composer本身不支持断点续传，但因分阶段执行、保留临时文件及多级缓存复用，重试install/update通常有效；zip损坏、installed.json截断或vendor结构异常时需清理vendor和缓存后重试。
Composer 本身不支持传统意义的断点续传，但它的下载失败后重试机制 + 多级缓存设计，能实现“逻辑上接近断点续传”的效果；所谓“部分缓存自动重构”，其实是 Composer 在 install/update 过程中按需复用、跳过、补全的结果，不是主动触发的重建行为。
composer install 失败后直接重试为什么经常有效
因为 Composer 的执行是分阶段的：先拉元数据（composer.lock）、再逐个下载 dist 包（ZIP）、最后解压校验写入 vendor/。只要 composer.lock 已生成、部分包已成功解压，重跑 composer install 就会跳过已完成步骤。
- 它会检查
vendor/下是否存在对应包目录且composer.json版本匹配，存在则跳过下载和解压 - 临时 ZIP 文件保留在
vendor/.cache/或全局cache-dir/files/，下次重试优先复用 - 若某个包下载中断但 ZIP 已写入一半，校验失败后该文件会被丢弃，下次重试重新拉取
- 注意：
installed.json被截断、vendor/目录结构损坏时，重试会卡住或报错，此时必须清理
缓存被污染导致“看似重试实则没更新”的典型表现
你删了 vendor/package-name，运行 composer install 却发现它秒装——不是网络快，而是 Composer 直接从本地缓存解压了一个旧 ZIP。这种“假重试”容易掩盖真实问题。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 查缓存路径：
composer config cache-dir - 进
files/子目录，用find . -name "*vendor-package-name*"定位 ZIP 文件 - 删掉匹配的
.zip（别删整个files/，否则所有包都要重下） - 再运行
composer install或composer require vendor/package-name，才会真正走网络 - 这个动作在 CI/CD 流水线里尤其关键：缓存卷复用时，旧 ZIP 可能比镜像源还“新”
哪些错误说明必须手动清理而非依赖重试
遇到这些提示，别等重试三次，立刻停手清理：
-
The zip extension and unzip command are both missing—— 实际是上一步 ZIP 损坏，导致后续解压失败 -
Failed to extract vendor/package-name: unable to open archive—— ZIP 文件不完整或权限异常 -
Invalid argument supplied for foreach()报在vendor/composer/installed.json—— 该文件被截断，说明写入过程被中断 - 对应操作：
rm -rf vendor+composer clear-cache+composer install
想绕过大 ZIP 下载？用预缓存 + --prefer-dist 强制走本地
Composer 不支持 HTTP 分块下载，但能完全跳过 ZIP 下载阶段：把包提前解压好放 cache 里，让它“复制即安装”。这在离线环境或超大包（如 Laravel vendor ZIP >100MB）时最实用。
- 手动从 packagist.org 找到目标版本的
dist.url（JSON 中字段），下载 ZIP 并解压 - 放入缓存目录：
COMPOSER_CACHE_DIR/files/vendor-package-name/version-hash/，里面要有完整解压后的文件树 - 确保
composer.json中该包版本锁定（如"vendor/package": "1.2.3"），否则 Composer 可能忽略本地缓存 - 运行
composer install --no-interaction --prefer-dist，它会优先查files/目录并直接复制 - 注意：
php.ini的memory_limit和max_execution_time仍需调高，复制+校验大目录也会触发超时
真正难处理的从来不是“断点续传”，而是缓存路径隐式复用、ZIP 校验时机模糊、以及 vendor/ 目录状态和缓存状态不同步——这些细节不暴露在命令行里，却决定重试到底是在修路，还是在填坑。
