使用 composer install -vvv 可查看完整调试日志，包含 HTTP 请求、JSON 响应及依赖解析细节；需确保 curl 可用并配合 –no-progress 和 2>&1 | tee 保存完整输出。
composer install 时看不到详细错误，怎么开调试模式
composer 没有传统意义上的“调试模式”开关，但所有命令都支持 -v（verbose）参数来逐级展开输出。最常用的是 -vvv，它会显示完整的 http 请求、json 解析过程、依赖解析树和每一步的包操作。
常见错误现象：执行 composer install 卡住、报错只有一行“Installation failed”，或提示 “The requested package does not exist”，但没说明是哪个源、哪次请求失败。
-
-v：显示基本步骤（如“Loading composer repositories”） -
-vv：加上包下载路径、版本比对逻辑 -
-vvv：打印完整 curl 请求头/体、JSON 响应原始内容、回溯栈（关键！遇到 404 或 500 时靠它定位镜像或私仓问题） - 注意：
--debug是个误导性参数——它只影响插件加载日志，**不增加安装过程的可见性**，别用它代替-vvv
查看完整安装日志，包括被跳过的包和缓存行为
默认情况下，Composer 会跳过已安装且满足约束的包，并静默使用本地缓存，导致你误以为“没走网络”或“没更新”。要确认真实行为，必须结合 -vvv 和环境变量 COMPOSER_MEMORY_LIMIT（防 OOM 中断）一起用。
使用场景：CI 环境里安装突然变慢、某次构建拉到了旧版包、怀疑缓存污染。
- 加
COMPOSER_CACHE_DIR=/tmp/composer-cache可隔离缓存，排除本地残留干扰 - 加
COMPOSER_NO_INTERACTION=1避免交互式提示中断日志流 -
composer install -vvv 2>&1 | tee install.log把全部输出（含 stderr）存为文件，方便搜索Downloading、Writing lock file、Skipped - 注意：日志里
using version ^2.3 for monolog/monolog表示版本解析完成，而Downloading https://repo.packagist.org/p2/monolog/monolog.json才是真正发请求
为什么 -vvv 日志里找不到 HTTP 错误码？
因为 Composer 默认用 ext-curl，但某些环境下（如 docker Alpine、PHP 编译缺失 ssl 支持）会 fallback 到 stream_wrapper，后者不暴露状态码。此时 -vvv 只显示“Failed to decode JSON”，实际是 403 或 404 被吞了。
性能 / 兼容性影响：强制启用 curl 可解决——在 composer.json 的 config 段加 "secure-http": true 并确保 extension=curl 已启用；否则日志永远缺关键上下文。
- 检查是否真用了 curl：
composer diagnose输出中找 “curl: OK” - 若显示 “curl: Not available”，需重装 PHP 或加
--with-curl - 私有仓库返回 401 时，
-vvv日志里只会写 “Invalid credentials”，不会打印响应体——这是设计限制，得靠抓包或服务端查日志
CI 环境下如何稳定捕获完整日志而不被截断
很多 CI 平台（如 github Actions、gitlab CI）默认限制 stdout 长度或超时，导致 -vvv 日志被砍掉关键段落。不能只靠重定向，得配合超时放宽和输出控制。
参数差异：--no-progress 必须加，否则进度条字符（r、ANSI 控制符）混入日志，让 grep 失效；--ansi 反而会让日志含颜色代码，增加解析难度。
- 推荐命令：
timeout 300 composer install --no-progress -vvv 2>&1 | tee composer-debug.log - GitHub Actions 中，加
shell: bash -e {0}防止某个步骤失败后继续执行，掩盖真实错误点 - 日志文件超过 10MB 后部分平台会自动折叠，建议用
grep -A 5 -B 5 "Error|exception|failed" composer-debug.log快速定位
事情说清了就结束。真正卡住的时候，90% 是 -vvv 没加全，或者 curl 没生效，剩下 10% 是 CI 环境把日志截了——先盯住这两处，比翻文档快。