composer install 才是让本地 vendor 与 composer.lock 对齐的正确命令;update 必改 lock 并重算依赖,install 则严格按 lock 安装且通常不修改 lock,仅在 content-hash 不匹配等特殊情况下重写。
composer
update 会改代码,
才只同步
很多人想“只更新 lock 文件内容”,其实是误解了目标:你不是要“更新 lock”,而是要“让本地 vendor 和 lock 文件对齐”——这恰恰是
的本职工作。
的作用是根据
重新计算依赖、写入新版本到
,并安装,它一定会改 lock,也一定会动 vendor。
常见错误现象:
显示
被修改,但你没运行
—— 很可能是别人提交了 lock 文件,而你本地 vendor 缺失或不一致,却误用了
去“修复”,结果生成了带时间戳、哈希值差异的新 lock,引发合并不必要的冲突。
正确做法:只要 lock 文件已存在且你不想升级任何包,就只运行
它会严格按 lock 中记录的版本、哈希、源地址安装,不查 packagist,不重算依赖树
如果 lock 文件里有平台配置(如
)或插件配置(如
),
也会校验并报错,而不是静默跳过
为什么
有时还是改了
?
正常情况下它不该动 lock,但以下几种情况会导致意外重写:
和
的
不匹配(比如手动编辑过 json 但没更新 lock)——install 会自动重写 lock 来同步 hash
lock 文件里记录的 PHP 版本(
)和当前运行环境不一致,且启用了
覆盖,Composer 会重写 lock 中的 platform 段以反映实际环境
使用了
或
等标志,导致某些插件无法执行初始化逻辑,部分插件(如
旧版)可能触发 lock 重生成
验证方式:运行
,它会模拟执行并告诉你是否需要重写 lock —— 如果输出里有 “would update lock file”,说明上面某条条件被触发了。
Composer 2.9.6
Composer 2.9.6 是 PHP 生态中高效、稳定的依赖管理工具。此版本在性能与兼容性上进一步优化,改进了依赖解析算法,提升大型项目中的安装与更新速度。它支持并行下载任务,显著减少等待时间,并增强了与私有仓库及镜像源的交互稳定性。同时修复了多项命令行交互与内存使用相关的缺陷,确保在复杂依赖关系下依然可靠运行。无论是新项目初始化还是现有系统维护,Composer 2.9.6 都能为开发者提供流畅、精准的依赖管理体验。
下载
是个假动作
这个命令在 Composer 2.2+ 才加入,但它**不做任何事**:它只是检查
是否能被解析、是否与
基本兼容,然后退出。不会重写 lock,也不会安装包,连网络请求都不发。
它存在的唯一用途是 CI 流水线里的轻量校验:确保 lock 文件格式合法、没被破坏
如果你希望 lock 内容“更新”(比如合并分支后 lock 有冲突,你想用某一方的版本),必须先人工解决冲突,再运行
验证是否可执行
别把它当成
的等价物——Composer 没有纯 lock 同步模式
多人协作时 lock 文件频繁冲突怎么办?
根本原因不是工具问题,而是团队没对齐依赖管理节奏。最常被忽略的一点是:
不仅记录包版本,还记录完整哈希、下载源、PHP 平台约束——这些字段对换行符、JSON 格式、空格都敏感。
强制统一 Git 的换行符设置:在项目根目录加
,写入
所有成员禁用 IDE 自动格式化 lock 文件(PhpStorm/VS Code 默认会 prettify JSON,破坏原始缩进和键序)
避免混合使用 Composer 版本:1.x 和 2.x 生成的 lock 结构不同(如
拆分),混用必然冲突
小范围更新依赖时,用
明确指定包,比全量
更可控
真正麻烦的从来不是怎么更新 lock,而是 lock 里藏着太多隐式上下文:PHP 小版本、扩展启用状态、甚至 CI 环境里的代理配置。这些细节一旦漏掉,
就会静默降级或跳过某些包,而你只在部署时报错。
composer installcomposer.lockcomposer installcomposer updatecomposer.jsoncomposer.lockgit statuscomposer.lockcomposer updatecomposer updatecomposer installplatformplugin-api-versioncomposer installcomposer installcomposer.lockcomposer.jsoncomposer.lockcontent-hashplatformconfig.platform.php--no-scripts--no-pluginshirak/prestissimocomposer install --dry-runcomposer update --lockcomposer.lockcomposer.jsoncomposer installnpm install --package-lock-onlycomposer.lock.gitattributescomposer.lock text eol=lfpackages-devcomposer update vendor/package-nameupdatecomposer install