Composer报错90%源于本地环境或依赖约束冲突，需紧盯报错末尾的Conclusion、Root requirements和Found conflicting requirements定位根因，再用composer why-not或prohibits等命令精准验证。
Composer 报错 90% 不是网络问题，而是本地环境或依赖约束冲突；直接换镜像、删 vendor 或重试，反而掩盖真实卡点。
看懂报错末尾的 Conclusion 和 Found conflicting requirements
Composer 不会笼统说“装不上”，它会在报错最末明确写出推理失败的落点。重点盯住这三类信息：
-
Conclusion:开头的句子，比如Conclusion: don't install monolog/monolog 2.10.0—— 这是它回溯出的首个不可解节点 -
Root requirements段落：你composer.json里写的原始需求，比如"laravel/framework": "^10.0" -
Found conflicting requirements段落：两个包对同一依赖提出的互斥要求，例如package-a requires symfony/console ^5.4但package-b requires symfony/console ^6.2
别跳过，直接翻到报错最末 10 行开始读。这些不是日志噪音，是唯一指向根因的线索。
用 composer why-not 定位拦路包
你想装 guzzlehttp/guzzle:^7.8 却失败？运行：
composer why-not guzzlehttp/guzzle:^7.8
它会列出所有阻止安装的约束，比如：
myapp/myproject dev-main requires php (^8.2)some/sdk v3.1.0 requires php (^7.4)Root composer.json requires guzzlehttp/guzzle ^7.8
这时你就知道：问题不在 Guzzle，而在 some/sdk 和你的 PHP 版本不兼容。如果输出里出现 ext-intl 或 ext-gd，说明缺扩展，用 php -m 验证即可。
注意：composer why-not 要求 Composer ≥ 2.2；低于该版本会报 Command "why-not" is not defined，此时改用 composer prohibits vendor/package 或 composer update --dry-run -v 替代。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
区分 composer install 和 composer require 的失败逻辑
这两个命令触发的解析路径完全不同，排查方向也得跟着变：
-
composer install读取composer.lock精确还原，报错多在「下载阶段」或「autoload 生成失败」；若composer.lock是刚生成的，优先检查vendor/权限、磁盘空间或autoload配置语法错误（比如"App\": "app//"多了个斜杠） -
composer require foo/bar要重新计算依赖树，报错更常出现在「版本冲突」或「平台约束不满足」；若报Conclusion: don't install foo/bar v2.0.0，说明已有依赖锁死了某个包的旧版本，用composer prohibits foo/bar:^2.0查谁在拦着
别删 composer.lock —— 它记录的是上一次验证可行的版本组合；删了反而让问题更难复现，尤其在 CI 或协作环境中。
加 -vvv 而不是 -v 或 -vv 查安装卡点
-vvv 是唯一能暴露 Composer 安装卡死根因的开关。它输出原始 HTTP 响应体、SAT 求解器每一步排除了哪些版本、临时文件路径、插件崩溃的精确行号；而 -v 只告诉你“正在下载”，-vv 顶多显示 404 Not Found，根本看不到 gzip 解码失败或 SAT 回溯风暴。
关键现象对应：
- 看到
Failed to decode response: zlib_decode(): data error→ 网络中间件（如代理、CDN）损坏了压缩响应 - 日志停在
Resolving dependencies through SAT后无下文 → 不是网络问题，是约束太紧导致求解器陷入死循环 - 出现
Exception trace→ 直接定位到哪个插件、哪行 PHP、甚至哪个扩展缺失（如ext-foobar在config.platform里写了但没装）
保存并快速过滤日志的关键操作：
- 运行
composer update -vvv 2>&1 | tee debug.log，完整捕获所有输出 - 用
grep -i "error|exception|failed|zlib|SAT" debug.log快速聚焦关键行 - 特别注意日志开头几行：
Reading ./composer.json failed说明 JSON 格式错误，比后面几百行冲突更早暴露根因
复杂点在于：-vvv 日志量极大，且很多关键线索藏在中间某一行；不保存重定向、不 grep 过滤，基本等于没开。
