composer require 是添加新依赖的唯一安全入口,它完整执行声明→解析→写入→安装四步;漏掉--dev会导致测试工具误入生产依赖,CI加--no-dev时因类未加载而崩溃。

composer require 是添加新依赖的唯一安全入口
它不只是“安装一个包”,而是完整走完「声明→解析→写入→安装」四步:修改 composer.json 的 require 或 require-dev 字段、触发依赖求解、更新 composer.lock、下载并写入 vendor/。漏掉 --dev 就把测试工具装进生产依赖,后续上线跑 composer install --no-dev 会直接报 Class not found。
常见错误现象:
- 执行
composer require phpunit/phpunit后,phpunit出现在require下(不该出现),而非require-dev - 本地能跑通,CI 流水线加了
--no-dev就崩,因为 autoloader 试图加载被跳过的类
正确做法:
- 开发用工具一律加
--dev:composer require --dev phpunit/phpunit:^10 - 运行时组件不加
--dev:composer require monolog/monolog:^3 - 如果误装进
require,手动删composer.json里那行,再跑composer update phpunit/phpunit(此时它已不在 require 列表中,update 会移除)
composer update 是依赖图重算,不是“升级”
composer update 不读 composer.lock,而是重新拿 composer.json 去 SAT 求解器里跑一遍——所有 require、conflict、PHP 版本、稳定性标记都参与约束计算。结果可能和上次完全不同,哪怕只改了一行 ^2.0 → ^2.1。
容易踩的坑:
- 执行
composer update无参数,等于让整个依赖树“重新谈判”,极可能引入不兼容变更(比如某间接依赖悄悄升了 major 版) - 以为
composer update vendor/package只动那个包——其实它的子依赖、冲突规则、平台要求全都会被重新评估 - 在 CI 或部署机上误跑
update,导致composer.lock被覆盖,下次install拉到的版本就变了
建议操作:
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 仅在明确要升级某个包且已验证兼容性时,用
composer update vendor/package - 加
--dry-run先看会动哪些包:composer update guzzlehttp/guzzle --dry-run - 升级后立刻提交新的
composer.lock,否则别人install还是旧版本
composer install 只认 lock 文件,不协商
只要 composer.lock 存在,composer install 就完全忽略 composer.json 里的版本范围(比如 "^3.0"),只按 lock 里记录的精确版本(如 "3.4.2")拉取。这是多人协作和生产部署可重复性的基石。
关键细节:
- 首次项目初始化(无
composer.lock)时,install行为等价于update,会生成 lock 文件 - 若你改了
composer.json(比如加了个包),再跑install会警告:Warning: The lock file is not up to date...,但不会自动修复 -
composer install --no-dev不是“跳过 dev 包”,而是跳过require-dev字段里所有包的安装和 autoloader 注册——但它们仍可能被require手动加载,造成隐式依赖
什么时候该用哪个命令?看动作意图
别记“什么场景用什么命令”,盯住你正在做的动作:
- 想加一个新包 → 用
composer require(记得分清--dev) - 想让 lock 文件跟上
composer.json的变更(增删改包或版本) → 用composer update(带包名更安全) - 想确保当前环境和别人一模一样(CI、预发、线上) → 只用
composer install(且 lock 必须在 git 中)
最常被忽略的一点:lock 文件里的 content-hash 是对 composer.json 内容的哈希。哪怕你只在 json 里多打一个空格,install 就会警告 lock 过期——这不是 bug,是设计用来揪出“我以为没改但其实改了”的隐形变更。










