加 -v 或 -vvv 参数可快速定位问题包，-vvv 显示下载地址、解压路径、脚本执行及 HTTP 请求细节；配合 --no-scripts、检查 installed.json、注释私有源等方法进一步排查。
Composer install 时卡住或报错，怎么快速定位是哪个包的问题？
直接看 composer install 输出末尾的错误行，但更关键的是加 -v（verbose）或 -vvv（最高日志级别）。它会打印出每个包的下载地址、解压路径、脚本执行顺序，甚至 HTTP 请求头。比如遇到 Could not fetch https://repo.packagist.org/p2/monolog/monolog.json，说明网络或 Packagist 域名解析失败；若卡在 Running update for vendor/package 后无响应，大概率是该包的 post-install-cmd 脚本死循环或阻塞。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 用
composer install -vvv --no-scripts排除自定义脚本干扰，确认是否脚本导致卡顿 - 检查
vendor/composer/installed.json是否存在且结构完整——如果缺失，说明安装中途被中断，删掉vendor/和composer.lock重试比硬调更省时间 - 临时把
repositories配置里的私有源注释掉，验证是否源不可达引发超时
想看 Composer 加载某个类时到底用了哪个版本的库？
Composer 不是运行时加载器，它只管安装和生成 vendor/autoload.php。真正决定类来源的是 PSR-4/PSR-0 映射和 ClassLoader::findFile() 的查找逻辑。调试核心是：在目标类被 require 前，打断点或输出 spl_autoload_functions()，确认当前生效的是 Composer 的 ClassLoader 实例。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 在入口文件顶部加
var_dump(get_included_files());，确认vendor/autoload.php已加载 - 在怀疑的类文件开头插入
echo "Loaded from: " . __FILE__;，验证实际加载路径是否符合预期（比如是否误加载了全局安装的同名包） - 用
composer show vendor/package查版本，再对比vendor/vendor/package/目录下composer.json的version字段——二者不一致说明本地修改未提交或用了path类型仓库但没跑composer update
调试 Composer 自身行为，比如为什么跳过某些包的更新？
Composer 的依赖解析由 Composer\DependencyResolver\Pool 和 Solver 完成，但日常调试不需要读源码。重点观察 composer update -v 的输出中 “Resolving dependencies through SAT” 阶段的日志，它会逐条打印冲突原因。例如出现 Root composer.json requires php ^8.1 but your php version (8.0.30) does not satisfy that requirement，说明 PHP 版本不匹配，不是包本身问题。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 用
composer depends vendor/package查谁依赖了这个包，避免盲目删composer.lock - 加
--with-dependencies参数强制更新子依赖，否则composer update vendor/package默认只更新顶层包 - 检查
composer.json中是否有"minimum-stability": "stable"却试图 requiredev-master，这种组合会导致解析失败且提示模糊
想改 Composer 源码验证某个逻辑，但改完不生效？
Composer 是 phar 打包的可执行文件，which composer 看到的通常是 /usr/bin/composer 或 ~/.composer/vendor/bin/composer，它们指向的是 phar 包，不是 PHP 源码。直接改 vendor 里的 composer/composer 目录无效。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 用
composer self-update --snapshot切换到开发版（基于最新 main 分支），再配合git clone https://github.com/composer/composer.git本地调试 - 设置环境变量
COMPOSER_HOME指向测试目录，避免污染全局配置 - 最简验证法：在
src/Composer/Command/InstallCommand.php的execute()开头加throw new \Exception('hit');，然后用php /path/to/composer/src/Composer/Command/InstallCommand.php直接运行（需先装好依赖），确认改动路径正确
真正的难点不在改哪行，而在于 Composer 的 resolver 逻辑高度状态化，一次 update 可能触发上百次约束检查。与其单步跟 Solver::solve()，不如先用 composer prohibits 和 composer why-not 把冲突关系具象化——多数“诡异行为”其实只是语义版本约束没理解透。
