想精简vendor目录体积？Composer结合插件移除无用文件和多余语言包-composer-PHP中文网

vendor目录变大因未清理开发文件及多语言资源；用composer-cleaner按包精准排除translations等路径，并配合--no-dev与--classmap-authoritative部署可安全瘦身。

想精简vendor目录体积？composer结合插件移除无用文件和多余语言包

为什么 vendor 目录会突然变大？ `composer install` 默认不清理开发期文件（如 `.git`、`tests/`、`docs/`），也不过滤语言包或文档资源。很多包（比如 `symfony/console`、`laravel/framework`）自带多语言 `translations/` 或 `resources/lang/`，而你的项目可能只用中文或英文。这些冗余文件在部署时毫无价值，却占了 20%–40% 的 vendor 体积。

更麻烦的是：手动删容易误伤 autoload 映射，composer dump-autoload 也不会自动修复路径——结果就是 Class not found 错误。

用 composer-installers-extender + composer-cleaner 精准裁剪这两个插件配合使用，能声明式地剔除指定路径，且不破坏 PSR-4 自动加载：

`composer require --dev johnpbloch/composer-installers-extender`：让 Composer 支持自定义安装路径规则（为后续 clean 提供钩子基础）

`composer require --dev symfony/flex`（可选但推荐）：新版 Flex 自带 `symfony:remove` 命令，可批量删 `translations/` 和 `doc/`

`composer require --dev dealerdirect/phpcodesniffer-composer-installer` 不要装——它只是个例子，实际要用 `composer require --dev roave/composer-dev-dependencies` 或更轻量的 `composer require --dev mnapoli/composer-cleaner`

装完 composer-cleaner 后，在 composer.json 里加：

"extra": {
  "cleaner": {
    "exclude": [
      "/tests/",
      "/Tests/",
      "/docs/",
      "/documentation/",
      "/Translations/",
      "/translations/",
      "/locale/",
      "/lang/",
      "/CHANGELOG.md",
      "/README.md"
    ]
  }
}

执行 composer update --lock 再 composer install，插件会在安装后自动扫描并 unlink() 匹配路径——注意：它只删文件，不改 vendor/autoload.php，所以不会导致类加载失败。

删语言包要按包名精细控制不是所有包的语言目录都叫 `translations/`；比如 `monolog/monolog` 用 `src/Monolog/Translator/`，`doctrine/dbal` 把翻译放 `lib/Doctrine/DBAL/Tools/Console/Helper/` 里。硬删 `/translations/` 可能漏掉或误删。

更稳妥的做法是：在 composer.json 的 extra.cleaner.exclude 中按包声明：

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

"extra": {
  "cleaner": {
    "exclude": [
      "monolog/monolog:/src/Monolog/Translator/",
      "doctrine/dbal:/lib/Doctrine/DBAL/Tools/Console/Helper/",
      "symfony/translation:/Resources/translations/"
    ]
  }
}

这样每条规则只作用于指定包路径，避免全局误伤。注意路径开头不要带 vendor/，插件内部会自动拼接。

CI/CD 部署时务必加 --no-dev + --optimize-autoloader

即使用了 cleaner，composer install 默认仍装 require-dev 依赖，并生成未优化的 autoloader。这会让 vendor 多出几 MB，且加载慢。

上线部署必须用：composer install --no-dev --optimize-autoloader --classmap-authoritative
--classmap-authoritative 让 Composer 完全信任 classmap，跳过文件系统扫描，既提速又防止因 cleaner 删除文件后触发 fallback 查找失败
如果用了 opcache.preload，还要确保 vendor/composer/autoload_classmap.php 里没有残留已删类的映射——cleaner 不动 classmap，所以建议每次 clean 后跑一次 composer dump-autoload --classmap-authoritative

真正难处理的是那些把语言文件硬编码进逻辑的包（比如某些老版本 phpunit 在运行时动态 require en.php），这种不能靠路径删除，得升版本或换包。别省那点空间，去踩运行时找不到文件的坑。