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