如何强制Composer重新下载并安装所有依赖(Reinstall)?

17次阅读

composer 无原生 reinstall 命令,需组合 clear-cache、删 vendor/ 和 –no-cache 实现强制重装;默认 install 复用缓存与 lock 文件,不触发新下载。

如何强制Composer重新下载并安装所有依赖(Reinstall)?

Composer 没有原生的 reinstall 命令,但可以通过组合操作实现「强制重新下载并安装所有依赖」的效果。关键在于清除已缓存的包、删除已安装的 vendor 文件,并跳过 lock 文件的校验逻辑。

为什么 composer install 不会重新下载已存在的包?

默认情况下,composer install 严格按 composer.lock 安装,且优先从本地缓存(~/.composer/cache)提取 ZIP 或 git 克隆,不会触发新下载,即使远程包已更新或本地文件损坏。

  • 缓存命中时,composer install 直接解压缓存 ZIP,不走网络
  • vendor/ 目录存在且 composer.lock 未变,Composer 认为“已就绪”,跳过任何重装逻辑
  • 即使手动删了 vendor/composer install 仍会复用缓存,不是“重新下载”

真正强制重装:清缓存 + 删 vendor + 重生成 lock(可选)

要确保每个包都从远程源重新拉取、解压、安装,必须切断缓存路径和本地残留影响:

  • 运行 composer clear-cache 清空全局 ZIP/Git 缓存
  • 执行 rm -rf vendor/ composer.locklinux/macOS)或 rmdir /s vendor && del composer.lockwindows)
  • 再运行 composer install --no-cache —— --no-cache 强制跳过缓存,所有包走实时下载

注意:--no-cache 是关键开关,否则即使清了缓存,Composer 在某些版本中仍可能回退到临时缓存机制。

如果只想重装而不改依赖版本(保留 lock)

有些场景下你希望保持 composer.lock 的版本锁定,但依然强制重装全部包(比如修复因磁盘损坏导致的 vendor/ 文件不一致):

  • 先备份当前 composer.lock(可选)
  • 运行 rm -rf vendor/ && composer clear-cache
  • 执行 composer install --no-cache --ignore-platform-reqs(后者可绕过 php 扩展缺失等阻断)
  • 不删 composer.lock,就能保证版本完全一致,只是全部重新下载安装

此时 composer install 会读取 lock 文件中的 exact commit hash 或 version,并强制从源重新 fetch,而非复用缓存。

常见错误现象与应对

遇到以下情况,大概率是没真正切断缓存或遗漏步骤:

  • 执行完命令后 vendor/ 里部分包体积异常小 → 缓存未清干净,或漏了 --no-cache
  • 提示 Failed to clone ... repository not found → 某些私有包源配置丢失,需检查 auth.jsonrepositories 配置
  • composer install 速度极快,且无下载日志 → 缓存仍在生效,确认是否加了 --no-cache

最稳妥的一行命令(Linux/macOS):

composer clear-cache && rm -rf vendor/ && composer install --no-cache

windows 用户请分步执行,避免 && 失效;另外注意 Composer 2.2+ 默认启用 cache,--no-cache 不可省略。

text=ZqhQzanResources