应保留 vendor 和 composer.lock，用 composer why-not 查阻断链、composer show -s 看生效版本、composer update --with-dependencies 精准更新，并隔离全局包以避免冲突。
别删 vendor 或 composer.lock —— 这只会让冲突更难定位，且大概率重演失败过程。真正要做的，是让 Composer 把“谁在封杀目标版本”这件事说清楚。
用 composer why-not 查清阻断链
当 composer install 报错 “Conclusion: don’t install xxx” 或 “found x packages with version constraints that differ”，说明依赖图无法收敛。此时最直接的线索是运行：
composer why-not vendor/package:version
例如：composer why-not guzzlehttp/guzzle:^8.0。它会逐级列出所有阻止该版本安装的包及其约束条件，比看报错日志直观得多。常见阻断来源包括：
- 某个 require 包（如
spatie/laravel-backup）声明了"guzzlehttp/guzzle": "^7.0" - PHP 版本不匹配（
guzzlehttp/guzzle:^8.0要求 PHP >= 7.4，而你本地是 7.2） - 同一包被多个上游以互斥版本引入（如
symfony/console被yii-base和phpunit分别拉入 v5.4 和 v6.3）
确认实际生效的依赖版本用 composer show -s
composer show -s 显示当前已解析并生效的依赖树，能一眼看出哪些包被重复引入、哪些版本被自动裁剪。重点观察：
- 重复出现的包名（如
psr/log、symfony/polyfill-php81），记录其不同版本及上游路径 - 若某包只显示一个版本但有多个引入路径，说明 Composer 已按“最近声明优先”做了裁剪，冲突尚未爆发
- 若命令直接报错
require does not match constraints，说明冲突已阻断解析流程，必须干预
这比 composer depends 更适合快速定位多版本共存问题，尤其在 Yii3 等框架项目中常见。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
精准更新而非全量重算：用 --with-dependencies
想升级某个包又怕牵连其他稳定依赖？别用 composer update（它默认重算整棵树），改用：
composer update vendor/package --with-dependencies
例如：composer update monolog/monolog --with-dependencies。这个参数的作用是：只允许升/降级该包及其直系子依赖，其余包版本不动。关键点：
- 不加
--with-dependencies，Composer 往往拒绝执行，报 “无法满足要求” - 不能写成
composer update "monolog/monolog:^3"—— 引号 + 波浪号会让它去找兼容最新版，不是你想要的精确控制 - 执行后立刻
git diff composer.lock，确认改动范围是否符合预期
全局包与项目依赖混用时的隔离方案
如果 composer install 成功但运行时报 Class not found 或 Cannot redeclare，很可能是全局安装的包（如 php-cs-fixer）和项目内同名包版本冲突。解决方式不是卸载全局包，而是隔离调用：
- 把工具类包移到项目内：
composer require --dev friendsofphp/php-cs-fixer - 统一通过
./vendor/bin/php-cs-fixer调用，而非全局命令 - 在
composer.json的scripts字段里定义快捷命令，避免手动敲长路径
CI/CD 或 Docker 中还要注意 UID 一致问题：构建时别用 USER root 执行 composer install，否则 www-data 用户可能无权读取 vendor 目录。
依赖冲突的本质不是版本数字打架，而是约束无法同时满足。最常被忽略的一点是：composer.lock 里记录的实际版本，往往比 composer.json 写的约束更真实 —— 它是你当前环境唯一跑得通的解。所以任何调整前，先看 lock 文件里那个包到底装了什么版本，再决定是改约束、换包，还是升级 PHP。
