答案是删除composer.lock和vendor目录后运行composer update重新解析依赖。该错误表明composer.lock中记录的某依赖版本在源中不存在，需先确认包名与版本是否真实可用，再通过composer update依据composer.json重生成锁文件。

composer install 报 “has been locked to a version that does not exist” 怎么办

这不是分支支持问题，而是 composer.lock 里记了一个根本不存在的版本号——比如包被删了、私有镜像没同步、或标签被强制重写了。Composer 没法下载一个不存在的 zip 或 tag，直接报错退出。

• 先看错误原文：Package vendor/name has been locked to version x.y.z, but this version does not exist —— 记下 vendor/name 和 x.y.z
• 用 composer show vendor/name 查这个包在当前源里实际有哪些可用版本；如果返回空或报 404，基本确认版本已失效
• 如果是私有包，检查 Git 仓库对应 tag 是否存在、CI 是否推送失败、镜像源是否配置了权限 token
• 别只删 vendor/，必须连 composer.lock 一起删，否则 composer install 会卡在“Lock file does not exist”
• 删完后运行 composer install，它会重新读 composer.json 并生成新 lock —— 这才是真正的“重解析”，不是“强制安装”

为什么删了 lock 还是装不上？

常见错觉：删了 lock 就能自由装最新版。实际上，composer install 没 lock 文件时会直接报错，根本不会尝试解析依赖。真正触发重算的是 composer update。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

• composer install 的设计目标是“精确还原”，它只认 lock 文件，不看 composer.json 的约束
• composer update 才会读 composer.json、调用 SAT 求解器、生成新 lock —— 这个过程可能降级、升级甚至跳过某些包
• 如果想最小干预，用 composer update vendor/name --with-dependencies，只重算这个包及其子依赖，避免整棵树震荡
• 加 --dry-run 先预览变更：composer update vendor/name --dry-run，看它打算升/降到哪版

老项目依赖锁死在 dev-main 分支，但远程已删分支

不是“分支不受支持”，是 Composer 锁定了一个已消失的开发引用（比如 "dev-main": "dev-main#abc123"），而该 commit 被 force-push 覆盖或分支被删除。

• 运行 composer show vendor/name，如果输出里没有 dev-main，说明源里已不可达
• 不要手动改 lock 文件 —— 它的 hash 校验会失败，composer install 直接拒绝加载
• 正确做法：删掉 composer.lock 和 vendor/，然后 composer install（自动 fallback 到最新 stable tag）或 composer update（按 composer.json 约束选可用分支）
• 若必须保留 dev 分支行为，改 composer.json 的 require 为具体 commit hash："vendor/name": "dev-main#xyz789"，再 composer update vendor/name

platform 配置导致“锁定版本不兼容当前 PHP”

报错里带 Your lock file does not contain a compatible set of packages，往往不是包本身问题，而是 composer.json 里 "config": {"platform": {...}} 写死了 PHP 版本，但你本地环境不匹配。

• 检查 composer.json 顶部是否有 "platform": {"php": "8.2.10"} 这类配置
• 运行 php -v 确认真实 PHP 版本，再查锁文件里某个包的 require php 条件（比如 monolog/monolog v3.5.0 要求 php: >=8.1）
• 临时绕过用 composer install --ignore-platform-reqs 可以过安装阶段，但运行时大概率报 Function not found —— 这不是解决方案，只是诊断手段
• 长期方案：删 lock + 改 platform 值为实际环境版本，或干脆删掉 platform 配置让 Composer 自动探测

真正麻烦的不是版本号不存在，而是锁文件里混了不可验证的引用（比如私有包 commit hash、dev 分支、未发布的 pre-release tag），这些一旦源端变动，本地就完全失联。处理时优先验证源可用性，再决定是删 lock 重来，还是精准调整 composer.json 约束。