Failed to extract 错误需精准删除损坏ZIP而非全量清缓存，先通过composer install -v定位包名，再进cache/files目录模糊搜索并删除对应ZIP；若仍失败，须同步备份并删除vendor与composer.lock，最后用composer install --no-cache --force-checksums重装。

Failed to extract 错误必须手动删 ZIP，不是清全量缓存

看到 Failed to extract vendor/symfony/console 或 Corrupted zip file: monolog/monolog，别急着跑 composer clear-cache。这类错误本质是 ~/.composer/cache/files/（Linux/macOS）或 %APPDATA%\Composer\Cache\Files（Windows）里某个 ZIP 文件损坏，Composer 拿着坏包硬解压，直接报错卡住，不会自动跳过。

正确做法是精准定位后只删那个 ZIP：

• 盯住 composer install -v 输出末尾，找 Extracting 或 Downloading 后紧跟着的包名（如 symfony/console）
• 查缓存路径：composer config --global cache-dir
• 进 files/ 子目录，用包名模糊搜索：ls -l *console*.zip（Linux/macOS）或 PowerShell 中 Get-ChildItem "$env:APPDATA\Composer\Cache\Files" -Recurse -Filter "*console*.zip"
• 只删匹配的 ZIP；别碰 repo/ 和 vcs/ —— 它们不参与解压

删 ZIP 后还失败？vendor 和 composer.lock 必须同步清理

只删 ZIP 不够。Composer 会校验 composer.lock 里硬编码的 dist.sha256 值，和当前缓存 ZIP 不匹配就拒绝安装。漏掉 composer.lock 就白删 vendor/，尤其 CI 环境中，它若含旧源地址，重装永远走错路。

必须三步同步操作：

• 备份：cp composer.lock composer.lock.bak（Linux/macOS）或 copy composer.lock composer.lock.bak（Windows）
• 删干净：rm -rf vendor composer.lock 或 rd /s /q vendor & del composer.lock
• 重装加参数：composer install --no-cache --force-checksums —— --no-cache 跳过本地 ZIP，--force-checksums 让校验失败立刻退出，不污染 vendor/

磁盘空间不足导致解压失败，TMPDIR 才是关键

composer clear-cache 只清 ~/.composer/cache/，不碰系统临时目录。而 Composer 默认把 ZIP 下载、解压、重命名全放在 /tmp（Linux/macOS）或 %TEMP%（Windows）里做——这个分区往往只有几 GB，才是爆满真凶。

Academic Composer Upload

辅助学术写作，包括查找资料、生成大纲、引用扩写及润色风格，同时确保引用规范。

下载

必须改 TMPDIR：

• Linux/macOS：export TMPDIR="/mnt/bigdisk/tmp"; mkdir -p "$TMPDIR"; chmod 777 "$TMPDIR"
• Windows：set TMPDIR=C:\bigdisk\tmp（CMD）或 $env:TMPDIR="C:\bigdisk\tmp"（PowerShell）
• 验证：echo $TMPDIR（Linux/macOS）或 echo %TMPDIR%（Windows）
• 别只改 COMPOSER_CACHE_DIR：不改 TMPDIR，解压阶段照样撞上 No space left on device

metadata 更新滞后？repo/ 目录和 installed.json 都得清

运行 composer update 拉不到新版本，常因 metadata 缓存没刷新。虽然 composer clear-cache 清了 files/ 和 vcs/，但 ~/.composer/cache/repo/https---packagist.org/ 下的 packages.json 和 provider-*.json 还在用旧快照，vendor/composer/installed.json 也锁着已安装版本。

真正要删的三处：

• rm -rf ~/.composer/cache/repo/https---packagist.org/
• rm -f vendor/composer/installed.json
• rm -f composer.lock

之后再跑 composer update，观察日志是否出现 Downloading https://packagist.org/packages.json —— 有这行才说明 metadata 真的重拉了。