Composer 官方不提供 reinstall 子命令;所谓“重装”需组合操作,推荐使用 composer install --force-reinstall(仅强制重解压已锁定包)或彻底清空 vendor 后执行 composer install。

Composer 没有 reinstall 命令
直接说结论:Composer 官方不提供 reinstall 子命令。你在终端输入 composer reinstall 会收到 Command "reinstall" is not defined 错误。所谓“强制重装”,实际是开发者自己组合操作,最常见的是 composer remove vendor && composer install 或 composer remove xxx && composer require xxx —— 但这两者行为并不等价,差异关键在锁文件、依赖解析和安装策略。
composer remove xxx && composer require xxx 的真实行为
这个组合看似“重装”,实则触发了两次独立的依赖求解:
-
composer remove xxx会从composer.json中删掉该包,并从vendor/删除其代码,同时运行一次composer update(受限于剩余依赖),可能降级或升级其他包 -
composer require xxx再次读取composer.json和composer.lock,按当前锁文件中记录的版本(如果存在)安装;若锁文件无该包记录,才走最新稳定版 + 依赖兼容性求解 - 它**不会强制刷新整个依赖图**,也不保证还原到最初
composer install的状态 - 如果
xxx是被其他包间接依赖的,remove可能连带卸载其他包,后续require又可能引入不一致的子依赖版本
composer install --force-reinstall 才是真重装
这才是 Composer 原生支持的“强制重装”机制,但它只作用于已锁定的包,不改变版本号:
- 它跳过所有本地
vendor/xxx目录存在性检查,强制重新解压/复制对应包的归档(zip 或 git clone) - 不修改
composer.json,不重算依赖,不触碰composer.lock,因此版本完全确定 - 适合场景:vendor 文件损坏、符号链接错乱、git hook 失效导致 autoload 不更新
- 注意:它对通过
pathrepository 引入的本地包无效(因无归档可重装)
composer install --force-reinstall
彻底清空并还原的可靠做法
想真正回到 composer.lock 描述的原始状态(包括所有嵌套依赖版本),唯一可靠方式是:
- 删除整个
vendor/目录(不要只删某个包) - 确保
composer.lock文件未被修改(git checkout composer.lock 如果需要) - 运行
composer install(不是update)
这比反复 remove/require 更快、更可预测,也避免了 lock 文件和 json 不同步的风险。很多人忽略的一点是:composer update xxx 虽然也能“刷新”,但它会重新运行依赖求解器,可能升到新 minor 版本 —— 这和“重装”本质不同。










