Composer vendor目录太大如何办_Composer vendor瘦身教程【核心】

最安全高效的 vendor 目录瘦身方案

说到 vendor 目录臃肿，问题往往不在于包的数量，而在于默认安装时塞进了大量运行时根本用不着的“附件”——比如 .git 仓库、tests/ 测试目录、docs/ 文档、examples/ 示例，甚至 CHANGELOG.md 这类文件。手动去删这些目录风险极高，那些令人头疼的 Class not found 错误，十有八九就是这么来的。

用 composer install --no-dev --prefer-dist --remove-vcs 重建 vendor

这组命令堪称“黄金搭档”，是见效最快、也最稳妥的瘦身起点。注意，这里必须用 install 而不是 update，因为它会严格依据 composer.lock 文件重新拉取依赖并进行裁剪：

• --no-dev：直接跳过 require-dev 区块里的所有开发依赖包（比如 phpunit、phpstan），这一下就能省出几百 MB。
• --prefer-dist：强制下载打包好的 zip 压缩包，而不是克隆完整的 git 仓库。这些发行版（dist）包通常已经预先移除了 tests/、docs/、.github/ 等非必要目录。
• --remove-vcs：在安装过程中自动删除每个包里的 .git 目录。有些发行版包可能仍残留 .git 文件夹，这个参数就是最后的保障。

配置 archive.excludes 在解压阶段精准过滤

不过，--no-dev 只解决了“不安装开发包”的问题，对于那些已安装的生产依赖包内部的 tests/ 等目录，它无能为力。要真正删除它们，得在解压阶段就动手。Composer 官方没有提供这个开关，但社区有一个可靠且轻量的插件可以胜任：composer-archive-excludes。

• 首先安装插件：composer require --dev composer-archive-excludes
• 然后在项目的 composer.json 文件的 config 部分添加配置："archive": {"excludes": ["/tests/", "/docs/", "/examples/", "/.github/", "/CHANGELOG.md"]}
• 之后每次执行 install 或 update，这些指定的路径在解压 zip 包时就会被直接跳过，根本不会落到磁盘上。

⚠️ 这里有个关键提醒：千万别图省事去运行类似 find vendor -name tests -type d -exec rm -rf {} + 这样的命令。因为有些包（例如旧版本的 monolog）会把一些处理器的示例代码也放在 tests/ 目录下，贸然删除直接会导致应用挂掉。

加上 --classmap-authoritative 强制关闭文件扫描

这一步不减体积，但它能让前面的“瘦身”努力真正生效。这个参数会让 Composer 的自动加载器完全依赖 vendor/composer/autoload_classmap.php 这个类映射文件，彻底绕过 scandir() 遍历整个 vendor/ 目录去寻找类文件的过程。

• 首先，确保 "optimize-autoloader": true 已经写入了 composer.json 的 config 部分。
• 运行命令生成权威类映射：composer dump-autoload --optimize --classmap-authoritative --no-dev
• 后续重建 vendor 时，可以带上参数：composer install --no-dev --optimize-autoloader --classmap-authoritative，这样安装完成后将只保留 classmap 里声明的路径。

这对于容器环境、NFS 共享存储或只读文件系统尤其关键。没有这个优化，即使你删除了 tests/ 目录，自动加载器在扫描时仍可能因为路径缺失而报错。

别忽略 composer depends 和 composer show --tree

vendor 体积膨胀，有时是因为引入了整条冗余的依赖树。举个例子，你可能只想用 monolog/monolog，结果它把 symfony/console、symfony/filesystem 等一大堆你的核心框架（如 ThinkPHP 或 Lara vel）根本用不到的包也拖了进来。

• 查询某个包被谁引入了：composer depends symfony/console
• 查看完整的依赖树状结构：composer show --tree
• 确认某个包是否真的被代码加载：可以在项目里全局搜索 use Symfony\Console 或 new ConsoleApplication() 等用法，同时检查配置文件是否有间接启用。
• 移除包前务必先试运行：composer remove symfony/console --dry-run，看看会连带影响哪些包。

真正棘手的是那些自动加载（autoload）配置不干净的包——比如它的 autoload.classmap 配置里包含了 tests/ 路径。遇到这种情况，要么 fork 代码库，删除相关配置后发布一个私有版本，要么直接向上游项目提交 PR 来修复。