composer why-not 能直接定位冲突源头，逐层展示依赖阻断链，如 A→B→C→D 的版本互斥关系；若返回空则需检查 Packagist 是否存在目标版本。
composer why-not 能直接告诉你谁在拦路
遇到 Your requirements could not be resolved 报错时，别急着删 vendor 或改 composer.json。先用 composer why-not 定位冲突源头，它会逐层展开阻断链：A 依赖 B ^2.0 → B 要求 C 1.5 → C 写了 "conflict": {"D": ">=3.0"} → 你项目里却声明了 "D": "^4.0"。
常见误操作是看到报错就去搜“怎么跳过冲突”，但真正该做的是看清谁在阻止、为什么阻止。如果 why-not 返回空，说明目标版本根本不在 Packagist 可见范围内，这时该查 composer show vendor/package 看实际发布的 tag 列表，而不是硬调约束。
更新范围越小，SAT 求解器越不容易卡死
composer update 全量解析整个依赖图时，SAT 求解器会暴力回溯所有可能组合——尤其当项目有 30+ 包、含 conflict 字段或多个私有源时，耗时可能从秒级跳到小时级。这不是网络慢，是算法复杂度爆炸。
- 只更新关键包：
composer update laravel/framework symfony/console --with-dependencies - 升级大版本（如 Laravel 9→10）时，先删
composer.lock，再单步执行composer require laravel/framework:^10.0 - 临时移除
composer.json中的"conflict"字段仅用于诊断（完事立刻还原），能快速验证是否为硬互斥导致卡死
镜像失效和缓存污染常被当成“依赖问题”
看起来卡在 Loading composer repositories，实则可能是 Composer 在 fallback 到 packagist.org 慢速拉取元数据。只要 composer.json 里存在 "repositories" 字段（哪怕空数组 {}），全局镜像就会失效。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
确认镜像是否生效：composer config -g repo.packagist 必须输出完整 URL（如 https://mirrors.aliyun.com/composer/），末尾带 /，且类型为 composer。清缓存后进缓存目录手动确认 downloads/ 和 files/ 为空；再跑 composer install -v，日志中应出现 Downloading 而非 Using cache。
锁文件冲突不是靠删解决的
多人协作时 composer.lock 合并出冲突标记（如 <<<<< HEAD），不能直接删掉重生成。运行 composer update --lock 才是正确做法——它会基于当前 composer.json 和已有的依赖关系重新计算哈希、补全缺失条目、清除冲突标记。
更隐蔽的问题是 composer.lock 里记录的包版本与 composer.json 不一致（比如某包在 json 里已删，但 lock 里还留着）。此时 composer validate 会报类似 Required package "vendor/package-name" is not present in the lockfile 的错误，必须用 composer update --lock 修复，而不是手动编辑。
依赖冲突的本质不是版本数字对不上，而是约束逻辑不可满足。最容易被忽略的是 conflict 字段的隐式影响，以及 repositories 配置对镜像策略的破坏性覆盖——这两点往往让问题看起来像“随机发生”，其实每次都有迹可循。
