composer require 默认重写 composer.lock,因其语义是“添加依赖并落实到生产环境”,需确保本地验证的版本能被 CI/线上通过 install 精确还原;唯一跳过 lock 更新的方式是加 --no-update 参数。

composer require 为什么默认会改 lock 文件
因为 composer require 的语义就是「添加依赖并立即落实到生产环境」:它会更新 composer.json、安装包、刷新 autoload.php,**同时重写 composer.lock**。这不是副作用,是设计目标——确保你本地跑通的版本,能被 composer install 在 CI 或线上精确还原。
所以不存在“不更新 lock”的原生模式。所谓“不更新”,其实是绕过 lock 生效逻辑,或让 lock 变更最小化:
-
composer require后不提交composer.lock→ 其他人install时仍用旧 lock,实际没装上新包(危险!) - 先
composer require --no-update,再手动composer update vendor/package-name→ 锁定只动这个包,避免全量重算 - 用
composer update --lock补救:如果已改了composer.json但不想动 vendor,就立刻执行它来同步 lock
想加包但跳过 install 和 lock 写入?用 --no-update
--no-update 是唯一能让 require 停在「只改 composer.json」这一步的参数。它不会下载包、不生成 autoload、也不碰 composer.lock。
适用场景很窄,比如:
- 批量编辑
composer.json(多个require),等全部写完再一次性composer update - CI 流水线中预置依赖声明,但由后续步骤统一安装(需确保后续真执行了
update或install) - 你在写文档或 demo,想展示“声明即代码”,暂不触发实际安装
注意:composer require foo/bar --no-update 后,foo/bar 不可用——new Foo\Bar() 仍会报错,因为 autoload 没注册、vendor 里也没文件。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
require 后 lock 变了但 vendor 没变?检查 platform 和镜像配置
有时你发现 composer require 执行完,composer.lock 的 content-hash 或 platform 字段变了,但 vendor/ 里包版本没动。这不是 bug,常见原因有:
-
composer.json里写了"config": {"platform": {"php": "8.1"}},而你本地 PHP 是 8.1.10 → lock 会记录"php": "8.1",但实际安装仍用 8.1.10,hash 却因此不同 - 全局镜像配置(
composer config -g repos.packagist)和项目级repositories冲突 → 元数据解析路径不同,导致 lock 中packages块的顺序或字段微调 - 用了
--with-dependencies(旧版)或--with(新版)→ 即使没升级主包,直系依赖的版本可能被拉高,lock 必须更新以反映新依赖树
这种变化通常安全,但若部署机 PHP 版本略低(比如锁的是 "php": "8.2",机器只有 8.1.20),composer install 会直接失败。别靠肉眼比对 lock,用 composer check-platform-reqs 直接看缺什么。
CI 中怎么安全地做 require + lock 同步
CI 脚本里最怕「本地能过,CI 报错」。关键不是禁掉 lock 更新,而是控制更新时机和校验方式:
- 所有
composer require必须在同一个 job 步骤里完成,且末尾加composer update --lock --no-install→ 确保 lock 与当前composer.json一致,又不触发安装(节省时间) - 紧接着运行
git diff --quiet composer.lock || (echo "lock changed, please commit"; exit 1)→ 强制把 lock 变更纳入代码审查 - 部署 job 用
composer install --no-dev --no-scripts --no-plugins,且必须指定 PHP 路径(如/usr/bin/php8.2)→ 避免因 PHP 版本差异导致 autoload 生成不一致
真正容易被忽略的点是:lock 文件里的 content-hash 不仅跟依赖有关,还跟 composer.json 文件本身的空白符、换行符、字段顺序强绑定。Git 设置 core.autocrlf 不一致,或编辑器自动删尾空格,都可能让同一份 composer.json 在不同机器上生成不同 hash —— 这时候 composer install 就会拒绝执行,哪怕 vendor 完全一样。










