composer remove是Composer 2.2+唯一原子化卸载命令:自动校验依赖、同步更新composer.json/composer.lock/vendor/ autoload,失败即回退;不处理代码中use/new、配置注册及autoload自定义路径,需人工清理。

composer remove 是唯一原子操作,不依赖外部工具
Composer 2.2+ 的 composer remove 是目前唯一被设计为原子操作的卸载命令——它不依赖 Git、Docker 或脚本封装,所有动作(改 composer.json、删 vendor/ 目录、更新 composer.lock、重建 autoload 映射)都在单次执行中完成,失败即全部回退,不会留下半截状态。
其他常见命令都不是原子的:composer install 和 composer update 虽然也带事务性保障,但它们只保证锁文件与 vendor 同步,不处理业务代码残留;rm -rf vendor/ && composer install 这类手动组合更不是原子操作,中间状态极易被中断或误用。
依赖检查在 remove 前自动触发,不靠人工 grep
composer remove 执行时会立即调用内置依赖图分析器,检查目标包是否被其他已安装包硬依赖。这不是“事后报错”,而是前置校验步骤——它基于 composer.lock 中完整的 packages 和 packages-dev 结构做 SAT 求解,确保移除后依赖图仍可满足。
遇到提示 Package is required by another package 时,说明校验失败,此时命令中止,什么都没动。你可以立刻用以下方式定位源头:
-
composer why monolog/monolog—— 查谁直接依赖它 -
composer show --tree | grep monolog—— 看它在依赖树中的位置 -
composer depends --recursive monolog/monolog—— 查间接依赖链(需 Composer 2.5+)
原子操作不覆盖业务层引用,三处残留必须人工确认
composer remove 再稳,也不会碰你代码里的这三类东西:
-
use语句和new Monolog\Logger()这类实例化调用 - Laravel 的
config/app.php中注册的服务提供者或别名 -
composer.json中autoload.files或autoload.psr-4里硬写的已删包路径
这些不清理,运行时必报 Class not found 或 Service provider not found。尤其注意 Laravel 9+ 默认启用 --classmap-authoritative,删包后若不 composer dump-autoload --classmap-authoritative,旧映射还在缓存里,问题反而更隐蔽。
想跳过实时依赖解析?用 --no-update,但得自己收尾
加 --no-update 参数会让 composer remove 只修改 composer.json,不碰 vendor/ 和 composer.lock。这适合 CI 流水线分阶段操作,或批量删包前先预检。
但它带来的代价是:你必须后续手动执行 composer update 或 composer install,否则 autoload 不刷新、依赖关系不生效。更关键的是,--no-update 下的依赖检查被跳过,无法提前发现“某包被其他包 require”的冲突——这个风险得你自己承担。











