Composer install报错主因是依赖约束逻辑矛盾，需用composer show确认topthink/framework版本及扩展要求，结合php -m验证环境，避免盲目删vendor；缺失composer.lock时先composer validate校验json合法性。
直接运行 composer install 并不能告诉你缺什么，它只会在缺失时报错。真正能快速定位依赖问题的，是组合使用几个诊断命令，而不是盲目重装。
确认项目根目录下有完整的 composer.json 和 lock 文件
ThinkPHP5 项目必须有 composer.json（声明依赖）和 composer.lock（锁定版本）。如果只有 composer.json 而没有 composer.lock，说明还没执行过安装；如果两个都没有，那根本不是 Composer 初始化的 TP5 项目（可能是手动下载的源码包）。
- 进入项目根目录后，先运行
ls -la（Linux/macOS）或dir（Windows）确认这两个文件是否存在 - 若
composer.lock缺失，composer install会尝试生成，但可能因网络或镜像问题失败；此时可先用composer validate检查composer.json格式是否合法 - 若
composer.json里没写"topthink/framework": "5.0.*"这类关键行，composer install就不会拉 TP5 核心
用 composer show 查看已安装的依赖列表
composer show 是最轻量、最直接的“当前装了啥”命令，不依赖 vendor 是否完整，只要 composer.lock 存在就能读出真实安装快照。
- 执行
composer show，观察输出中是否有topthink/framework及其版本（如5.0.24） - 如果列表为空或报错
Could not find package，说明vendor/目录不存在或损坏，需补装 - 若看到
topthink/framework但版本是6.x或8.x，说明项目被误升级过，和 TP5 不兼容 - 加参数
composer show topthink/framework可查看该包的详细信息，包括它 require 哪些扩展（比如php >=5.4.0,ext-json）
检查 PHP 环境是否满足 TP5 的硬性要求
TP5.0 要求 PHP >= 5.4.0，但实际常见问题出在扩展缺失，而非版本不够。报错 require(): Failed opening required '.../vendor/autoload.php' 表面是路径问题，根源往往是 ext-json 或 ext-pcre 没启用。
立即学习“PHP免费学习笔记（深入）”；
- 运行
php -v确认 PHP 版本不低于5.4.0 - 运行
php -m | grep -E "(json|pcre|mbstring|openssl)"（Linux/macOS）或php -m后人工查找（Windows），确认这些扩展已加载 - 若
ext-json缺失，TP5 启动时连composer.lock都解析不了，直接 fatal error - 别只信
phpinfo()页面——Web 服务器用的 PHP 配置可能和命令行不同，务必用php -m在终端验证
依赖冲突或安装中断后如何安全恢复
执行 composer install 卡住、内存溢出或中途 Ctrl+C，容易导致 vendor/ 半残、autoload_static.php 错乱，这时不能直接删 vendor 重来。
- 先运行
composer clear-cache清掉可能污染的缓存 - 再用
composer install --no-dev --prefer-dist -vvv加详细日志重试，-vvv 能暴露具体卡在哪一步（比如某个包的 zip 解压失败） - 如果仍失败，再删
vendor/和composer.lock，然后换国内镜像：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 最后执行
COMPOSER_MEMORY_LIMIT=-1 composer install避免内存限制中断
真正难排查的，是 PHP 扩展状态与命令行/WEB 服务不一致，以及 composer.lock 被手动修改却没重新 dump autoload。这两点不出问题时一切正常，一出就是 Class not found 却死活找不到原因。
