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

为什么 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 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)”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性,以及撰写结论。当用户输入以下任一指令时也会自动触发该功能: - “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),这种不能靠路径删除,得升版本或换包。别省那点空间,去踩运行时找不到文件的坑。

















