--no-dev 是 Composer 参数,用于跳过 require-dev 中的开发依赖,仅安装 require 中的运行时依赖。它适用于生产环境部署、构建轻量 Docker 镜像、性能优化及 CI/CD 构建阶段,可减少资源占用并提升安全性。执行 composer install --no-dev 或 composer update --no-dev 时,Composer 忽略开发工具如 PHPUnit 等。使用时需确保生产环境无需 dev 包,并可通过 composer dump-autoload --optimize --no-dev 进一步优化自动加载。

在使用 Composer 管理 PHP 项目依赖时,--no-dev 是一个常用参数,用于控制是否安装开发环境所需的依赖包。它的核心作用是跳过 require-dev 中定义的依赖项安装,仅安装项目运行所必需的正式依赖。
什么是 --no-dev 参数?
Composer 的 composer.json 文件中包含两个主要的依赖配置:
- require:项目运行必须的依赖,如框架、数据库组件等。
- require-dev:仅在开发或测试阶段需要的工具,如 PHPUnit、PHPStan、PHP-CS-Fixer 等。
当你执行 composer install --no-dev 时,Composer 只会安装 require 中的包,而忽略 require-dev 中的所有内容。
使用场景解析
在以下几种典型场景中,使用 --no-dev 非常必要:
- 生产环境部署:线上服务器不需要测试或代码检查工具,安装它们会浪费资源并可能带来安全风险。
- 构建轻量镜像:在 Docker 构建过程中,通过 --no-dev 减少镜像体积,提升部署效率。
- 性能优化:减少自动加载的类文件数量,略微提升应用启动速度。
- CI/CD 流水线中的构建阶段:某些构建流程只需核心依赖,避免引入不必要的开发工具。
常见命令对比
以下是不同命令的行为差异:
- composer install:安装所有依赖(require + require-dev)。
- composer install --no-dev:只安装 require 中的依赖,跳过 require-dev。
- composer update:更新所有依赖到符合约束的最新版本。
- composer update --no-dev:更新时也跳过开发依赖。
注意事项
使用 --no-dev 时需注意:
- 确保生产环境中确实不需要任何 dev 工具,例如某些项目可能误将调试工具放在 require-dev 中,但实际运行时用到。
- 执行 composer dump-autoload --optimize --no-dev 可进一步优化自动加载性能。
- 如果后续需要重新安装开发依赖,直接运行 composer install 即可恢复。
基本上就这些。合理使用 --no-dev 能有效区分开发与生产环境依赖,提升项目部署的安全性和效率。










