答案是删除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。
-
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 自动探测
