Composer依赖包移除与项目瘦身优化操作指南

为项目“瘦身”，清理不再使用的Composer依赖包，看似简单却暗藏风险。直接删除composer.json中的条目，并不等同于安全卸载。真正的彻底清理，意味着代码库和配置中不再包含对该软件包的任何显性或隐性引用。

请务必遵循一个核心原则：仅删除依赖声明，并不会自动清除自动加载配置与残留文件。你必须手动验证vendor/autoload.php能否正常加载，并确保代码中不存在任何未声明的类引用。

执行 composer remove 命令（官方推荐方法）

最安全、最推荐的做法是使用Composer 2.2及以上版本提供的remove命令。这是一条“一站式”指令，它能自动完成三项关键工作：从composer.json中移除指定条目、执行composer install以清理vendor/目录，并同步更新PSR-4等自动加载配置。

• 基本命令格式为：composer remove monolog/monolog。相比手动编辑配置文件再执行安装，此方法更能保障依赖关系树的完整性，避免出错。
• 若执行时遇到Package “xxx” is not required in your composer.json提示，无需紧张。这通常表明目标包是一个“传递性依赖”，即由你声明的其他主依赖包所引入。此时，应使用composer show -t命令查看完整的依赖树，找出引入它的上游包，再决定是否移除或更换该上游包。
• 命令执行完成后，务必检查composer.json文件，确认require或require-dev区块中对应的包名已完全消失。

手动编辑 composer.json 后必须运行 composer install

如果你偏好手动编辑composer.json文件来删除包，后续步骤至关重要。仅仅删除文件中的条目，Composer并不会主动清理vendor/目录下已安装但不再声明的包。这些残留文件如同“幽灵依赖”，未来可能引发自动加载冲突，或被其他代码意外调用。

• 编辑保存composer.json后，必须立即运行composer install --no-dev（生产环境）或composer install（开发环境）。此命令会强制Composer依据新的依赖声明重新解析并整理vendor/目录，从而移除无用的软件包。
• 若项目启用了自动加载器优化（例如在部署时使用了--optimize-autoloader参数），则在删除包后，记得重新生成优化后的加载器：composer dump-autoload -o。
• 请注意一个常见误区：切勿使用composer update替代composer install。update命令的主要目的是升级包版本，它会尝试更新所有依赖，这偏离了“清理瘦身”的初衷，除非你确实需要同步更新其他包。

全面检查残留类引用与自动加载问题

软件包从vendor/目录移除后，问题可能才刚浮现。最常见的错误是页面突然抛出Class ‘MonologLogger’ not found这类致命异常。这表明你的业务代码、配置文件或测试文件中，仍然存在对该包的硬编码调用。

• 第一步，执行全局代码搜索。利用IDE的全局搜索功能，查找类似use Monolog、new Logger、Monolog\（注意命名空间分隔符的转义）等关键词。
• 第二步，审查框架配置文件。重点检查config/目录下的配置文件、app/Providers/目录下的服务提供者，以及tests/测试目录。这些位置常注册有包的服务提供者、门面（Facade）或别名，移除包后必须同步清理。
• 第三步，验证自动加载映射。运行composer dump-autoload -p（-p选项表示仅处理PSR-0/PSR-4映射），可以快速检查自动加载配置是否干净。若执行失败，通常意味着存在未清理的映射条目。
• 特别注意测试依赖。某些包，例如phpunit/phpunit本身是通过require-dev引入的，但你的测试用例中可能使用了类似@requires extension mbstring的注解。移除开发依赖后，这些测试可能无法运行，需要你删除或重构相关的测试逻辑。

归根结底，一个真正“瘦身成功”的项目，其标志不仅仅是vendor/目录体积的缩减。更关键的是，所有代码路径——包括那些不常执行的——都已彻底摆脱对已移除包的隐性依赖。最易被忽略的“死角”往往是配置文件中以字符串形式存在的类名、事件监听器数组、中间件注册列表等。这些地方不会立即引发错误，但会在某个特定请求触发时导致系统崩溃。因此，进行彻底而全面的检查，是确保项目长期健康稳定的关键一步。