这不是错误，是composer一致性保护机制：install只按composer.lock还原版本，改composer.json后需run composer update更新锁文件；dev分支需严格匹配大小写和dev-前缀；删lock后应run composer update而非install；镜像不同步时换源比清缓存更有效。
composer install 报 “Package is locked to version” 怎么办
这不是错误，是 Composer 的一致性保护机制在起作用：只要 composer.lock 里已记录某个包的精确版本（比如 "monolog/monolog": "2.9.0"），composer install 就只会还原它，哪怕你刚改了 composer.json 里的版本约束也无效。
常见诱因包括：
- 手动改了
composer.json中某包的版本（如从"^2.8"改成"dev-main"），但没运行composer update更新锁文件 -
--ignore-platform-reqs完全无效——它只跳过 PHP 版本或扩展检查，不干预依赖版本解析 - 执行
composer install本身不会更新锁，必须用composer update vendor/package
装 dev-main 分支失败？版本写法和大小写必须严格匹配
Composer 要求分支名必须带 dev- 前缀，且大小写、斜杠必须与远程仓库完全一致。GitHub 上是 main，就不能写 dev-master 或 dev-Main；写成 dev-main/fix（多斜杠）也会失败，报 Could not find a matching version，而不是更友好的提示。
正确做法：
- 在
composer.json的require中写明："vendor/package": "dev-main" - 确保项目根目录下已声明
"minimum-stability": "dev"，否则默认只认stable - 若仍失败，先运行
composer show -a vendor/package，确认远程确实存在该分支，且末尾标有dev标记
删 composer.lock 后 composer install 报错？命令用错了
直接删掉 composer.lock 再跑 composer install 会报错：Lock file does not exist. Run composer update to create it. ——因为 install 的设计前提就是锁文件存在。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
真正触发重算依赖的是 composer update，它读 composer.json 约束，调用 SAT 求解器生成新锁文件。所以：
- 想强制按新约束重装全部依赖：先
rm composer.lock，再composer update - 只想重装某个包且不升级子依赖：用
composer update vendor/package --no-update-with-dependencies - 如果只是修复损坏的
vendor/目录，保留锁文件，只删vendor/，再composer install即可
镜像不同步导致分支找不到？别清缓存，要换源或等同步
国内镜像（阿里云、腾讯云）通常有 10–30 分钟元数据同步延迟，尤其对新发版或 dev- 分支。你看到 Packagist 上已有 dev-main，但 composer install 找不到，大概率是镜像还没拉到最新元数据。
验证和应对方法：
- 访问
https://mirrors.aliyun.com/composer/p/vendor/package-name.json，看是否返回 404 或版本陈旧 - 临时切回官方源：
composer config -g repo.packagist composer https://packagist.org，再composer clear-cache && composer install - 不要信
composer clear-cache能“刷新镜像”，它只清本地缓存，不影响镜像服务端数据 - 若必须用镜像，等 30 分钟，或换华为云等已知同步更快的源
最易被忽略的一点：分支名大小写和远程仓库必须一字不差；镜像不同步时，换源比反复删缓存有效得多。
