composer 不支持 update 前自动清缓存，因 pre-* 钩子自 2.2 版起被移除；需清理的是框架运行时缓存（如 laravel 的 cache:clear），应在 post-update-cmd 中执行，并注意环境兼容性与 opcache 影响。
Composer 本身不支持在 composer update 前自动清缓存，因为它的事件钩子（如 pre-update-cmd）从 Composer 2.2 起已被移除，且官方明确不提供 pre-* 类钩子。 你看到的“更新前清缓存”需求，本质是误用了缓存机制或混淆了缓存层级——真正需要干预的，通常是项目级缓存（如 Laravel 的 cache:clear），而非 Composer 自身的下载缓存。
为什么没有 pre-update-cmd？
Composer 的脚本钩子只保留 post-*（如 post-update-cmd、post-install-cmd），pre-* 类钩子早在 v2.2 中被彻底废弃。这不是遗漏，而是设计取舍：防止用户在依赖未解析完成时执行破坏性操作（比如删 vendor/ 导致后续 autoload 失败）。
- 运行
composer update --dry-run可预览将变更的包，但不会触发任何钩子 - 试图用
alias cu='composer clear-cache && composer update'是 shell 层面的 workaround，不可被其他工具（如 CI）复用 - 某些老旧文档提到的
pre-update-cmd实际只存在于极早期 Composer 1.x 版本，2026 年已完全失效
composer clear-cache 什么时候该手动跑？
它清理的是全局下载缓存（~/.composer/cache/files/ 等），仅在以下真实场景下有必要提前执行：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 你刚切换了镜像源（如从 packagist.org 切到阿里云），旧缓存里的包哈希可能不匹配新源返回的内容
-
composer update报错类似file could not be downloaded: failed to open stream: Connection refused，且确认网络正常——大概率是缓存里存了损坏的 zip 包 - 你在调试
repositories配置，反复修改私有源地址，发现 Composer 总去旧地址找包（缓存元数据未及时失效）
注意：composer clear-cache 不影响 vendor/ 或项目运行时缓存，也不会加速 update 本身——它只避免重试失败下载。
真正该“更新前清理”的其实是项目缓存
如果你的框架（如 Laravel）在 composer update 后因配置/路由/类映射未刷新而报错，问题不在 Composer 缓存，而在框架自身的运行时缓存。此时应把清理逻辑移到 post-update-cmd，并确保它足够健壮：
- 不要直接写
php artisan cache:clear，先检查命令是否存在：if command -v php && [ -f artisan ]; then php artisan cache:clear 2>/dev/null || true; fi - 若项目未完全引导（如
.env缺失），artisan可能崩溃；改用文件级清理更稳妥：rm -rf bootstrap/cache/*.php storage/framework/views/* - 多个环境共用同一份
composer.json时，避免在post-update-cmd里硬编码APP_ENV=production，改用php -d variables_order=EGPCS artisan ...临时注入
最易被忽略的一点：Composer 的缓存和 PHP OPcache 完全无关。即使你 clear-cache 十遍，改了 app/Http/Controllers/ 下的代码却没生效，大概率是 PHP-FPM 进程里的 OPcache 没刷新——这得重启 fpm，不是 Composer 的事。
