Composer怎么排除包 Composer怎么不安装开发依赖【过滤】

7次阅读

直接加 –no-dev 参数即可跳过 dev 依赖,它会忽略 require-dev 中的包,不下载、不解析、不写入 vendor/,且不加载 autoload-dev 配置。

Composer怎么排除包 Composer怎么不安装开发依赖【过滤】

composer install 时跳过 dev 依赖怎么操作

直接加 --no-dev 参数就行,这是最常用也最可靠的方案。它会完全忽略 require-dev 区块里的包,不下载、不解析、不写入 vendor/,连 autoload-dev 配置都不会加载。

常见错误是只改 composer.json 里删掉 require-dev 再运行 install——这不行,因为 composer.lock 里还存着旧的 dev 包记录,install 会照着 lock 文件还原,删 JSON 不等于生效。

  • composer install --no-dev 是生产环境部署的标准动作
  • 如果已执行过没带 --no-devinstall,得先删掉 vendor/composer.lock(或用 composer update --no-dev 强制重生成 lock)
  • --no-devcomposer require 无效;想临时加个 dev 包但不进 lock,得用 composer require --dev --no-update xxx

composer update 怎么只更新非 dev 包

composer update --no-dev,效果和 install 一样:只处理 require 下的包,跳过所有 require-dev 项。但要注意,它仍会重新计算整个依赖图,只是最终不装 dev 包。

容易踩的坑是误以为 update xxx(指定包名)能自动绕过 dev 依赖——不会。composer update monolog/monolog 如果这个包同时被 requirerequire-dev 引用,它仍可能触发 dev 分支的版本变动,除非明确加 --no-dev

  • 想锁定 dev 包版本不动,又更新主依赖?老老实实删掉 require-dev 里的对应项,再跑 update --no-dev
  • --with-dependencies 这类参数和 --no-dev 共用时,依然不会把 dev 包拉进来
  • CI 脚本里建议统一用 composer install --no-dev,比 update 更快更确定

为什么 vendor/autoload.php 里还有 dev 类的 autoload 配置

因为 autoload-dev 是在生成 autoloader 时才合并进去的,而 --no-dev 只控制「是否安装包」,不控制「是否写 autoload 配置」。只要 composer.json 里还存在 autoload-dev 块,dump-autoload 就会把它编进去。

典型现象:代码里 class_exists('PHPUnitFrameworkTestCase') 返回 true,但实际 vendor/phpunit/phpunit 根本不存在——这就是 autoload 配置残留导致的假阳性。

  • 解决方法:删掉 composer.json 中的 autoload-dev,再跑 composer dump-autoload
  • 或者用 composer dump-autoload --no-dev,它会跳过 autoload-dev 的合并步骤
  • 注意:laravel 等框架的 phpunit.xml 可能依赖 autoload-dev,删了要同步检查测试配置

exclude-from-classmap 能不能当“排除包”用

不能。exclude-from-classmap 是给 autoload.classmap 用的路径过滤器,只影响自动加载映射生成,跟“不安装某个包”完全无关。有人想靠它屏蔽 phpunit,结果 vendor/ 里照样下满,磁盘照占,只是类找不到而已。

它真正的使用场景是:避免把测试文件、文档目录塞进 classmap 导致 autoload.php 膨胀或冲突。

  • 示例:"exclude-from-classmap": ["tests/", "docs/"] —— 这些路径下的 PHP 文件不会出现在 classmap 数组里
  • psr-4psr-0 autoload 没影响,它们走的是动态路径匹配
  • 别把它和 replaceconflict 混用,那些是包级声明,作用域完全不同

真正要排除一个包,只有两个干净做法:从 require-dev 删掉它,或用 --no-dev 控制安装阶段。其他绕路方案,后期都会在 autoload、CI、部署环节露出马脚。

text=ZqhQzanResources