“package x is not installed”说明composer.lock与vendor状态不匹配，属安装中断或残留导致的半残状态，非依赖冲突；应先rm -rf vendor && composer clear-cache，再composer install --no-interaction --prefer-dist。

composer install 报“package x is not installed”但 lock 文件存在

这说明 composer.lock 记录的包信息和本地 vendor/ 实际状态不匹配，不是依赖冲突，而是安装中断或残留导致的“半残状态”。常见原因有：
— composer install 过程被 Ctrl+C 或超时中断，部分包写入失败
— 手动删过 vendor/ 里的某些目录，但没清空 composer.lock
— CI 构建中用了 --no-scripts，跳过了某些必须的 post-install-cmd 步骤
解决方式不是重跑 composer install，而是先强制清理再重装：
— rm -rf vendor/
— composer clear-cache
— composer install --no-interaction --prefer-dist

composer install 失败提示 “found x packages with version constraints that differ”

这是 Composer 明确拒绝自动求解依赖树，本质是多个包对同一依赖提出了互斥要求（比如一个要 monolog/monolog:^2.0，另一个锁死在 1.26.1）。它不会猜你想要哪个版本，而是直接报错。
关键动作是让冲突显性化：
— 先运行 composer why-not monolog/monolog:2.9.0（把包名和你想升的版本换成实际值），看谁在阻拦
— 再用 composer prohibits monolog/monolog:2.9.0 查所有冲突路径
— 检查 composer.json 中是否手动写了矛盾的 require 条目（例如同时引入了不兼容 Laravel 10 的旧版 spatie/laravel-backup）
— 不要用 --ignore-platform-reqs 硬顶，那只会把问题延后到运行时报错

Discussion Composer

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

下载

lock 文件校验失败：“Required package 'x' is not present in the lock file”

这个错误意味着 composer.json 里声明了某个包，但 composer.lock 没记录它——通常是因为你改了 composer.json 后忘了跑 composer update 或 composer install 更新锁文件。
别手动往 lock 文件里加条目，那会破坏哈希校验。
正确做法只有两个：
— 如果只是新增依赖：运行 composer require vendor/package，它会自动更新 composer.json 和 composer.lock
— 如果是手动改了 composer.json：必须立刻执行 composer update --lock（Composer 2.2+ 支持该参数，只重算哈希、不升级包）
注意：CI 环境下应禁用 composer update，只允许 composer install；所有 lock 文件变更必须由人触发并提交，不能交给构建机自动生成

flock 不能解决 install 与 lock 不一致，但能防多线程写坏 lock 文件

很多人误以为加 flock 就能修复 install 失败，其实它只管一件事：防止多个 composer update 同时写 composer.lock 导致 JSON 截断或字段错位（表现为文件字节数每次都不一样、json_decode() 报 JSON_ERROR_SYNTAX）。
flock ./composer.lock -c 'composer update --no-interaction' 是有效的，但 flock 对 composer install 本身无意义——install 不写 lock 文件。
真正容易被忽略的是锁粒度：
— 锁必须作用于 composer.lock 文件本身，而不是某个临时目录或 PID 文件
— 所有涉及 composer update 的步骤（包括 Makefile、Jenkins job、GitHub Actions 的多个 step）必须共用同一把锁，否则无效
— Windows 下 flock 不可用，CI 场景建议统一用 Linux 容器