Composer如何删除依赖包：告别手动操作，拥抱原子命令
记住一个核心原则：删除依赖，请直接使用 composer remove。手动删除 vendor/ 目录或修改 composer.json 文件，都是给自己埋雷。只有 composer remove 能一步到位，同步清理包声明、物理文件、锁文件以及自动加载映射，堪称原子操作。
为什么不能只删 composer.json 再跑 composer install？
很多开发者会想：我先从 composer.json 里删掉那行依赖，再执行 composer install 不就行了吗？听起来合理，但这么做大概率会留下“幽灵依赖”，后患无穷：
vendor/目录里会残留子依赖。比如你删除了主包guzzlehttp/guzzle，但它的子依赖psr/http-message可能还留在那里，因为没有被其他包显式依赖。- 自动加载文件（如
vendor/composer/autoload_psr4.php）里，已删除包的命名空间映射可能依然存在。这会导致诡异的Class not found错误，而且很难定位源头。 composer.lock文件的哈希值会不匹配，在持续集成（CI）环境中可能引发构建失败或意料之外的版本漂移。
composer remove 的参数与识别逻辑
这个命令很智能，它能自动识别一个包是位于 require 区块还是 require-dev 区块，通常无需额外指定。当然，也有几个实用的参数组合：
composer remove phpunit/phpunit→ 自动从require-dev区块删除。composer remove monolog/monolog --dev→ 强制只处理require-dev中的同名包，忽略require区块。composer remove guzzlehttp/guzzle --no-update→ 仅修改composer.json，不立即重新安装依赖。适合批量操作后，再统一执行composer update。- 注意，它不支持一次删除多个包。像
composer remove a/b c/d这样的写法会报错，必须逐个执行。
遇到 “Package is required by another package” 怎么办？
别慌，这不是命令执行失败，而是 Composer 在尽职尽责地保护你的项目依赖一致性。例如，当你尝试 composer remove guzzlehttp/guzzle 被拒绝时，很可能是因为另一个包（比如 symfony/http-client）明确依赖它。这时可以按以下步骤处理：
- 先查明依赖链：使用
composer why guzzlehttp/guzzle或composer depends guzzlehttp/guzzle查看是谁在依赖它。 - 如果想连带清理那些只被该包引用的子依赖（例如
guzzlehttp/promises），可以加上--with-dependencies参数。 - 临时跳过检查（慎用）：使用
composer remove guzzlehttp/guzzle --no-update，然后手动运行composer update，让依赖解析器重新推导。这有一定风险。 - 再次强调，直接硬删
composer.json再跑composer install可能导致意外的依赖降级，尤其是在composer.lock文件包含精确哈希的情况下。
删除完成后，必须人工检查的三件事
composer remove 并非万能。它只管依赖管理本身，不会碰你的应用代码、配置文件或服务注册。因此，执行完命令后，这三项手动检查必不可少：
- 全局搜索代码引用：使用
grep -r "use GuzzleHttp\\" . --include="*.php"（注意命名空间中的反斜杠需要转义），查找所有use语句和new实例化调用。 - 检查配置文件：查看诸如
config/logging.php、config/app.php等配置文件，以及服务提供者（Service Providers）中，是否还有硬编码调用该包的地方。 - 确认自动加载生效：运行
composer dump-autoload --classmap-authoritative来刷新自动加载器。在 Lara vel 9+ 中，此模式默认启用，如果不刷新，可能会卡在旧的类映射里。 - 最终验证：执行
composer show guzzlehttp/guzzle应返回Package not found；检查目录ls vendor/guzzlehttp应提示No such file or directory。
最后，还有一个极易被忽略的角落：composer.json 文件中手动配置的 autoload.files 或 autoload.psr-4 路径。composer remove 不会清理这些配置，需要你亲自打开 JSON 文件检查并手动删除相关条目。
