composer clear-cache 不生效是因为它只清理 files/、repo/、vcs/ 子目录，不校验或强制替换损坏的 ZIP 文件，且残留解压文件或权限问题会导致重装仍失败。
缓存损坏时 composer clear-cache 为什么可能不生效
它只清 files/、repo/、vcs/ 三个子目录，但不会覆盖正在被读取的 ZIP 或解压残留；如果错误提示明确指向某个包（如 Failed to extract vendor/symfony/console），说明该包的 ZIP 文件已损坏，而 clear-cache 默认不会重试校验或强制替换——它删完就走，不管有没有残留临时文件。
常见现象：运行 composer clear-cache 后再 composer install，依然卡在同一个包上。这不是命令没执行，而是损坏 ZIP 还躺在 files/ 里没被删干净（比如权限问题导致部分文件跳过），或者解压后 vendor/ 目录里残留了半成品。
- 先确认报错里带的具体包路径，例如
monolog/monolog或laravel/framework - 查真实缓存位置：
composer config --global cache-dir - 进
$(composer config --global cache-dir)/files/，用ls -l *monolog*或find . -name "*monolog*.zip"定位对应 ZIP - 手动删掉那个 ZIP：
rm -f ~/.composer/cache/files/monolog/monolog-3.5.0.zip（Windows 用Remove-Item）
删除本地缓存目录的完整步骤（含权限与路径陷阱）
直接 rm -rf ~/.composer/cache 看似快，但容易触发后续 Permission denied 或 Cache directory does not exist 错误——因为 Composer 期望缓存目录存在且权限正确，不是空目录也不是 root 所有。
安全做法是分三步走：
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 停掉所有 composer 进程：
pkill -f composer（Linux/macOS）或任务管理器杀掉 php.exe（Windows） - 查路径并删目录：
rm -rf $(composer config --global cache-dir)（Linux/macOS），或 Windows 资源管理器中删%APPDATA%\Composer\Cache - 重建目录并设权限：
mkdir -p $(composer config --global cache-dir)，然后chown -R $USER:$(id -gn) $(composer config --global cache-dir)（Linux/macOS）；Windows 不需 chmod，但确保当前用户对目录有完全控制权
composer install 报错后要不要删 vendor/ 和 composer.lock？
要看错误类型。如果是 The PHP file ... is corrupted 或 unable to open archive，说明 vendor 里已有损坏文件，clear-cache 无法修复已写入的 vendor 内容——必须删 vendor/，否则重装会跳过已存在目录，继续用坏文件。
composer.lock 是否要删，取决于你是否想升级依赖：
- 只想恢复原状：保留
composer.lock，删vendor/，再跑composer install --no-cache --force-checksums - 想拉新版本：删
composer.lock+vendor/，再跑composer install（它会重新生成 lock） - 别用
composer update替代——它会重算依赖树，可能引入意外变更
为什么删完缓存还报错？重点检查这三处
缓存清了、vendor 删了、lock 也删了，composer install 还失败，大概率不是缓存问题，而是环境配置层面卡住：
-
composer.json里写了私有repositories，但源已下线或 URL 拼错——clear-cache不解决配置错误 - 镜像 URL 少了末尾
/，例如https://mirrors.aliyun.com/composer（缺斜杠），导致请求packages.json时 404，但 Composer 不报明显错误，只卡在 “Loading composer repositories” - CI/CD 中用了 NFS 挂载的缓存目录，
clear-cache只清了本地路径，实际缓存还在远程——得去挂载点手动删，或确认COMPOSER_CACHE_DIR环境变量是否生效
真正麻烦的从来不是删不删得掉，而是删完之后你以为问题解决了，其实只是把症状暂时盖住了。
