Composer update 会优先读取本地缓存(如ZIP包、dist包和metadata)以加速安装,但可能导致拉取旧版本或过期元数据;清缓存需用composer clear-cache,它安全删除archives/files/repo/artifact等目录,不触碰配置、token、插件或vendor。

Composer update 为什么会用到缓存
Composer 在执行 composer update 前,会优先从本地缓存(~/.composer/cache)读取已下载的包 ZIP、dist 包、metadata 等。这能加速安装,但也会导致你改了 composer.json 或切了分支后,仍拉到旧版本或过期元数据——尤其是当你在私有仓库调试、换 PHP 版本、或遇到 "Could not parse version constraint" 类错误时。
清空全部缓存的正确命令是 composer clear-cache
这个命令会删除:
– ZIP 包缓存(archives/)
– dist 包缓存(files/)
– repo 元数据(repo/,含 packagist.org 和私仓的 packages.json)
– artifact 缓存(如果用了 artifact repos)
它比手动删 ~/.composer/cache 更安全,因为会校验路径、跳过只读文件,并输出清理摘要。运行后你会看到类似:
Clearing cache (cache-dir): /home/user/.composer/cache Cache cleared successfully.
注意:composer clear-cache 不影响全局配置、auth tokens 或插件安装,也不清 vendor/ ——那是 composer install 的事。
使用 circleci/circleci-cli 和 circleci/orb-tools-orb SDK 来组合和验证 CircleCI Orbs。自动化 orb 打包、使用 conventional-changelog 进行语义化版本控制,并发布到 CircleCI Orb Registry。
哪些情况必须清缓存再 update
以下场景不清理缓存,composer update 很可能失败或行为异常:
- 刚升级 Composer 自身(如从 2.2 → 2.5),旧缓存格式可能不兼容
- 切换了 PHP 版本(比如从 8.1 切到 8.3),而缓存里存的是旧版
platform-check结果 - 私有 Packagist 替代服务(如 Satis、Private Packagist)更新了包版本,但本地缓存没刷新
- 遇到
Failed to decode response: zlib_decode(): data error或Invalid argument supplied for foreach()在RepositoryManager.php中
要不要加 --no-cache 参数
composer update --no-cache 是临时禁用缓存,但它不会清缓存,只是跳过读取。下次 update 还会用旧缓存。所以它适合单次验证是否缓存导致问题,不能替代 clear-cache。另外,--no-cache 会显著拖慢 update(尤其带大量依赖时),不建议日常使用。
真正要“从干净状态 update”,顺序只能是:composer clear-cache → composer update。中间别碰 composer.lock 或手动改 vendor,否则又引入干扰。










