require --dev 用于添加新的开发依赖,如 PHPUnit,将其写入 composer.json 的 require-dev 并安装;update --dev 则更新已声明的开发依赖至符合约束的最新版本,不添加新包。两者分别对应“添加”和“升级”操作,部署时使用 --no-dev 可避免开发依赖进入生产环境,确保安全轻量。

在使用 Composer 管理 PHP 项目依赖时,require --dev 和 update --dev 是两个常见但作用不同的命令。它们都与“开发依赖”有关,但触发的场景和行为有本质区别。
require --dev:添加新的开发依赖
当你运行 composer require --dev package/name 时,Composer 会做几件事:
- 将指定的包安装到当前项目中
- 把该包写入 composer.json 文件中的 require-dev 字段
- 更新 composer.lock 文件并下载实际代码到 vendor 目录
这个命令用于你在开发阶段需要但生产环境不需要的工具,比如 PHPUnit、PHPStan、PsySH 等。
举例:composer require --dev phpunit/phpunit 这条命令会让 PHPUnit 只在开发时可用,部署到生产环境时不会被自动安装(除非你没加 --no-dev 参数)。update --dev:更新已有的开发依赖
composer update --dev 的作用是执行依赖更新,并包含 require-dev 中列出的包。
默认情况下,composer update 会处理所有依赖,包括 require 和 require-dev。但如果你之前用 --no-dev 安装过依赖,或者在 CI/CD 环境中限制了 dev 依赖的安装,那么后续 update 行为可能不一致。
显式加上 --dev 能确保开发依赖也被检查版本并更新到符合约束的最新版本。
关键区别总结
两者的根本不同在于意图和时机:
- require --dev 是“添加”动作 —— 把一个新包加入开发依赖列表并安装
- update --dev 是“刷新”动作 —— 根据已有配置,升级已列出的开发依赖到兼容的最新版
你可以理解为:
require --dev 改变“要什么”,update --dev 执行“升级那些已经要的东西”。
生产环境的影响
无论你如何使用这两个命令,只要部署时运行 composer install --no-dev,所有 require-dev 中的包都不会被安装。
这意味着开发依赖不会进入生产系统,保障了环境轻量与安全。
基本上就这些。正确区分这两个命令,能让你更清晰地管理项目的开发工具链。










