composer require --dev 是安装开发依赖的正确命令,它将包写入 require-dev 并立即安装;composer install --dev 不存在,composer install 默认安装 require-dev,但 CI 或生产环境需加 --no-dev 避免冗余和冲突。

composer require --dev 安装开发依赖的正确写法
直接用 composer require --dev 就行,不是 composer install --dev,后者根本不存在——composer install 本身不接受 --dev 参数,它只按 composer.json 里已有的 require-dev 字段来装。
常见错误是以为加了 --dev 就能“临时启用 dev 依赖”,其实它只控制「把包写进 require-dev 并立刻安装」这个动作。
-
composer require --dev phpunit/phpunit:写入require-dev并安装 -
composer require phpunit/phpunit(没加--dev):写入require,变成生产依赖 - 如果项目已提交过
composer.lock,且你本地没删过vendor/,执行require --dev后会立即生效,不需要再跑composer install
require-dev 和 require 的实际区别不止是“要不要上线”
关键差异在安装行为和 CI 环境处理上:默认 composer install 会装 require-dev,但 CI 脚本常加 --no-dev 跳过它;而 composer update 默认仍会更新 require-dev 里的包,除非显式加 --no-dev。
这意味着:本地开发时 phpstan、pest 这类工具在 require-dev 里很安全;但一旦误放进 require,上线部署时就可能多拉一个 50MB 的静态分析工具,还可能因 autoload 冲突报错。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
-
require-dev中的包不会被autoload到生产环境自动加载器里(除非你手动配了autoload-dev) - 但它的类仍可能被
require或include显式加载——所以别在src/里直接new PhpUnitRunnerVersion() - 某些包(比如
symfony/var-dumper)在require-dev里,但你在config/dev/debug.php里用了它,那 dev 环境没问题,prod 环境就会Class not found
composer install --no-dev 在哪些场景下必须加
不是“上线才加”,而是只要运行环境不需要 dev 包,就得加。比如 Laravel 的 artisan optimize:clear 在生产环境跑,如果没加 --no-dev,可能会因为 phpunit 的 autoloader 规则干扰而报 Cannot declare class PHPUnitTextUIResultPrinter。
另一个典型场景是 Docker 构建:多阶段构建中,build 阶段装了所有依赖,但 final 阶段应该只复制 vendor/ 并加 --no-dev 重装,否则镜像里混进一堆测试工具,体积翻倍还带安全隐患。
- CI 流水线跑测试前一般不加
--no-dev(要跑 PHPUnit) - CI 打包生产镜像时必须加
--no-dev - Laravel
APP_ENV=production下,composer install建议始终加--no-dev,哪怕你没在代码里用它——避免 autoload 冲突和意外加载
require-dev 里放错东西的典型错误现象
最常踩的坑不是“装不上”,而是“装上了但出问题”:比如把 laravel/sail 放进 require-dev,本地 ./vendor/bin/sail up 没问题;但某天同事在没装 Docker 的机器上跑 composer install,结果卡在 exec: "docker": executable file not found —— 因为 sail 的 post-install-cmd 脚本被触发了,而它不在 require-dev 的“仅开发”语义里,属于基础设施依赖,该放 require 或干脆不走 Composer 安装。
-
Class 'NunoMaduroCollisionAdaptersLaravelCollisionServiceProvider' not found:Collision 放require-dev,但app.providers里写了它,prod 环境崩 -
Target class [TestsTestCase] does not exist:自定义测试基类放在tests/,但autoload-dev没配"psr-4": {"Tests\": "tests/"} -
PHP Fatal error: Uncaught Error: Class 'MockeryAdapterPhpunitMockeryPHPUnitIntegration':Mockery 在require-dev,但phpunit.xml的<extensions></extensions>里引用了它,而 PHPUnit 启动时早于 autoloader 初始化
dev 依赖不是“随便放的垃圾桶”,它和你的加载顺序、环境变量、甚至 shell 命令执行时机都咬得很死。一个没注意,就是半夜收到告警说线上日志里刷满了 class not found。

















