新依赖未出现在 composer.lock 中是因为 composer install 不读取 composer.json 的变更,必须运行 composer update 才能更新 lock 文件;直接修改 composer.json 后执行 install 会被忽略。

composer.lock 里没出现你刚加进 composer.json 的包?不是漏写,也不是网络问题,而是锁文件根本没被更新过——composer install 从不读 composer.json 的版本约束,它只照 composer.lock 装;新依赖不进 lock,就等于不存在。
为什么新 require 的包没出现在 composer.lock 里
因为 composer.lock 不是自动生成的,它只在 composer update(或首次 install 时 lock 缺失)时生成或刷新。直接改完 composer.json 就跑 composer install,Composer 会安静地忽略新增项,继续装 lock 里已有的旧依赖树。
- 执行
composer install后检查composer.lock的packages数组长度,和改前对比是否增加 - 运行
composer show vendor/package-name,如果报 “no such package”,说明它连解析都没进过 - Git 提交记录里若没看到
composer.lock变更,基本可断定没人运行过update
正确触发 lock 更新的命令是 composer update
想让新依赖落地到 composer.lock,必须显式运行 composer update,而不是 install。它会重读 composer.json 全部 require 和 require-dev,重新求解兼容版本,并把结果写进 lock 文件。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 只更新某一个包:
composer update vendor/package-name(避免全量升级引发 BC break) - 确保平台约束生效:检查
composer.json中"config": {"platform": {...}}是否与当前 PHP 版本匹配,否则update可能跳过或选错版本 - CI/CD 中禁止用
composer update替代install——它会破坏环境一致性,应先提交新 lock,再让所有节点用install还原
常见误操作:删 lock 后跑 install,结果包还是没进去
删掉 composer.lock 再执行 composer install,新版 Composer(v2.5+)会直接报错 Command "install" is not defined;旧版可能静默失败或退化为 update 行为,但结果不可控、不一致。
- 正确流程是:
rm composer.lock && composer update(重建 lock) - 如果只是想补上漏掉的包,且 vendor 已存在,用
composer update vendor/package-name --with-all-dependencies更安全 - 误删 lock 后别硬凑,先查 Git 历史:
git log -n 3 --oneline -- composer.lock,恢复最近一次干净的 lock 再补操作
修复后必须验证 lock 是否真正包含新依赖
光看 composer install 成功不代表完事。要确认新包确实进了 lock,且哈希和版本可复现。
- 用
grep -A 5 '"name": "vendor/package-name"' composer.lock检查是否存在对应块 - 比对
composer.lock中该包的version和dist.sha256是否与composer show输出一致 - 执行
composer check-platform-reqs,排除因 PHP 版本或扩展缺失导致该包被跳过解析的情况 - Git 提交前务必
git diff composer.lock,确认变更符合预期——手动生成或编辑 lock 是高危行为,绝对禁止
最容易被忽略的是:lock 文件内容由 composer.json 全文(含空格、换行、字段顺序)生成 content-hash,哪怕多一个空格,composer install 就会警告“lock file is not up to date”。所以改完 composer.json,必须走 update,不能靠手动修 lock 或跳过校验。

















