当运行 composer update 时包被移除,是因 Composer 根据依赖解析决定其不再需要或存在冲突。1. 包未在 composer.json 的 require 或 require-dev 中声明,且无其他依赖引用它;2. composer.lock 与 composer.json 不一致,导致临时安装的包被清理;3. 版本冲突使某些包被排除,Composer 选择兼容性更优的组合;4. 更新特定包时其依赖变更,导致原有依赖被废弃。应确保所有包正确声明、使用 composer require 安装、提交 lock 文件,并通过 composer why-not 和 show –tree 分析依赖。

当你运行 composer update 时,某些看似必要的包被移除,通常不是随机发生的,而是由 Composer 的依赖解析机制根据当前的 composer.json 和已安装状态做出的决定。下面是一些常见原因和应对方法。
1. 包不再被直接或间接引用
Composer 只保留被项目或其他包明确依赖的库。如果你手动添加过某个包,但后来修改了 composer.json,移除了对该包的引用(无论是直接 require 还是通过其他依赖引入),composer update 就会将其卸载。
检查方式:
- 查看
composer.json中的require和require-dev是否还包含该包。 - 运行
composer depends 包名查看谁在使用它。 - 如果没人引用,它就会被清理掉。
2. 锁文件(composer.lock)与 composer.json 不一致
composer update 会根据 composer.json 重新计算整个依赖树,忽略 composer.lock 的旧状态。如果你之前通过 require 添加了包但没提交到 composer.json(比如手动改过 vendor),这些“临时”安装的包不会被保留。
正确做法:
- 所有包都应通过
composer require vendor/package安装,确保写入composer.json。 - 不要手动删除或修改
vendor目录中的内容。
3. 依赖冲突导致替换或排除
某些包可能因为版本冲突被替代。例如 A 包要求 B 包 v1,C 包要求 B 包 v2,如果无法共存,Composer 可能选择不安装 A 包来满足整体兼容性,从而“移除” A 包。
表现:
- 执行 update 时看到 “Removing package xxx” 日志。
- 运行
composer why-not 包名 版本可查看为何未安装。
4. 使用了 –with-dependencies 但上游包变更
如果你更新某个特定包(如 composer update foo/bar),默认也会更新它的依赖。如果新版本的 foo/bar 不再需要你原来依赖的某个组件,那个组件就可能被移除。
建议:
- 更新前先查看变更日志(changelog)。
- 用
composer show --tree看依赖关系树是否合理。
如何避免意外移除?
确保:
- 所有必要包都在
composer.json中声明。 - 开发环境与生产环境保持一致(通过
composer install部署)。 - 提交
composer.json和composer.lock到版本控制。 - 不要跳过
composer require流程。
基本上就这些。Composer 移除包是因为它认为那些包“不需要”或“不兼容”。只要你的 composer.json 正确描述了需求,结果就是可靠的。