Composer install与Composer update的本质区别是什么？（新手必读）

composer install 严格遵循 composer.lock 安装确定版本，用于日常协作与部署；composer update 忽略 lock 文件重新解析依赖，仅应在开发阶段有明确目标并验证后使用。

什么时候该用 composer install？

这是你日常协作和上线部署时**唯一该用的命令**。

• 团队新人克隆项目后，直接运行 composer install —— 它会严格按 composer.lock 里写死的版本号安装，所有人得到一模一样的 vendor/
• CI/CD 流水线、Docker 构建、生产服务器部署，必须用 composer install --no-dev（跳过开发依赖）
• 本地改完代码想快速复现线上环境？删掉 vendor/ 后只跑 composer install，不碰 composer.json 里的约束
• 如果项目没有 composer.lock，install 会退化成首次解析，自动生成锁文件——但这属于例外，不是常态

为什么不能在服务器上乱跑 composer update？

它不是“升级工具”，而是“依赖重算引擎”。

• 它会忽略 composer.lock，联网重新求解整个依赖树，可能把 monolog 从 2.9.1 升到 3.0.0 —— 而 v3 已经移除了你正在用的 Monolog\Logger::addInfo() 方法
• 执行一次 composer update，composer.lock 必然被重写，且 diff 可能长达几百行，你根本没法肉眼判断哪些包变了、为什么变
• 它默认会更新所有包（包括 require-dev），哪怕你只想修一个安全漏洞；必须加 --with-dependencies 或限定包名，比如：

  composer update symfony/http-kernel --with-dependencies

• 耗时远高于 install：要解析约束、查 packagist、比对版本、解冲突、下载新 zip、验证哈希……部署窗口等不起

composer update 的正确打开方式

它只应在开发阶段、有明确目标、且做好验证的前提下使用。

如此AI员工

国内首个全链路营销获客AI Agent

下载

• 想升级某个包到新版？先确认 composer.json 里它的版本约束是否允许（比如从 "^1.2" 放宽到 "^2.0"），再运行 composer update vendor/package-name
• 修复已知 CVE？查 symfony security advisories 或 FriendsOfPHP，找到受影响包和修复版本，再针对性更新
• 升级后必须跑测试：vendor/bin/phpunit、phpstan、接口回归，甚至手动点一遍关键路径
• 更新完成并验证通过后，立刻提交新的 composer.lock 到 Git —— 这是让队友和线上环境同步变更的唯一方式

容易被忽略的关键细节

很多人以为 “有 composer.lock 就安全”，其实不然。

• composer install 不校验 composer.lock 是否和 composer.json 逻辑一致。如果你删了 composer.json 里某个包但忘了删 lock 里的记录，install 照装，但 Composer 不报错
• composer update 默认会更新 require-dev，而生产环境不该装这些。上线前务必用 composer install --no-dev，别指望 update 时加参数能“安全降级”
• Git 提交时漏掉 composer.lock，等于没锁 —— 所有后续 install 都变成首次解析，结果不可控