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

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-dev的install,得先删掉vendor/和composer.lock(或用composer update --no-dev强制重生成 lock) -
--no-dev对composer 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 如果这个包同时被 require 和 require-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('PHPUnit\Framework\TestCase') 返回 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-4或psr-0autoload 没影响,它们走的是动态路径匹配 - 别把它和
replace、conflict混用,那些是包级声明,作用域完全不同
真正要排除一个包,只有两个干净做法:从 require-dev 删掉它,或用 --no-dev 控制安装阶段。其他绕路方案,后期都会在 autoload、CI、部署环节露出马脚。









