composer install 失败时默认不生成日志，需手动启用 --verbose --profile 并重定向 stderr 和 stdout（2>&1）至文件，内存不足时还需设置 composer_memory_limit=-1。
Composer install 失败时默认不生成日志，需手动触发
Composer 本身不会在 composer install 或 composer update 失败时自动保存完整诊断日志。所谓“自动生成日志文件”是常见误解——实际必须显式启用日志输出并重定向到文件，否则错误仅显示在终端，且部分上下文（如 HTTP 请求头、完整堆栈、依赖解析过程）会被截断。
用 --verbose + --profile + 重定向捕获完整现场
真正有用的诊断信息需要组合三个关键参数，并通过 shell 重定向落地为文件：
-
--verbose（或简写-v）：输出详细错误堆栈、HTTP 响应状态、包下载过程 -
--profile：记录各阶段耗时，帮助识别是网络卡顿、解析阻塞还是脚本执行超时 -
2>&1：将 stderr（错误流）和 stdout 合并重定向，避免只捕获一半输出
推荐命令：
composer install --verbose --profile 2>&1 | tee composer-install-fail.log
这样既实时看到终端输出，又确保完整日志落盘。注意不要只用 > file.log，否则会丢失 stderr 中最关键的错误行（例如 Failed to decode response: zlib_decode(): data error）。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
某些错误需额外开启 COMPOSER_MEMORY_LIMIT 才能完整记录
当报错含 Allowed memory size exhausted 或进程被 SIGKILL 终止时，Composer 在内存不足时会提前退出，导致日志截断。此时需临时放宽限制：
- 运行前设置：
COMPOSER_MEMORY_LIMIT=-1 composer install --verbose --profile 2>&1 | tee composer-install-oom.log - 若用 Windows PowerShell：
$env:COMPOSER_MEMORY_LIMIT="-1"; composer install --verbose --profile 2>&1 | Out-File -Encoding utf8 composer-install-oom.log - 该环境变量仅影响当前命令，不会永久修改全局配置
日志里真正要盯住的几行关键线索
生成的日志动辄数 MB，不必通读。快速定位问题看这三类内容：
- 最末尾的
[ErrorException]或[RuntimeException]行——这是最终抛出异常的位置 - 靠近顶部的
Reading ./composer.lock或Resolving dependencies阶段卡住时间超过 30 秒，大概率是私有仓库 DNS 解析失败或认证失效 - 出现
Connection refused、SSL certificate problem、401 Unauthorized等字样的 HTTP 错误行，对应网络或凭证问题
如果日志里压根没出现 Resolving dependencies 就退出，说明连基础配置校验都没过——这时要检查 composer.json 格式是否合法（可用 composer validate 单独测），而不是埋头翻日志。
