ThinkPHP8安装报错90%以上是环境、镜像或残留文件问题，非框架bug；需换阿里云镜像、清缓存、检查PHP≥8.0.2及fileinfo等必需扩展、用create-project命令并清理vendor和composer.lock。
ThinkPHP8执行composer安装报错，90%以上不是框架问题，而是环境配置、网络源或残留文件导致的“假失败”。多数情况5分钟内可定位解决，关键在快速排除三类干扰：镜像不可用、PHP扩展缺失、vendor或lock文件残留。
换国内镜像源并清缓存
packagist.org在国内基本不可达，超时、404、连接拒绝都是典型表现，不是你网速慢，是路由被干扰。
- 全局切换阿里云镜像：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
- 验证是否生效：composer config -g repo.packagist，输出应为该URL
- 清除本地缓存：composer clear-cache（尤其之前失败多次后必须做）
- 临时加verbose参数看卡在哪：composer create-project topthink/think myapp --verbose
检查PHP版本与必需扩展
ThinkPHP8明确要求PHP ≥ 8.0.2，且以下扩展缺一不可：fileinfo（解压必需）、mbstring、json、curl、openssl、pdo。缺失常导致静默中断——终端没报错，但vendor不生成。
- 查PHP版本：php -v（低于8.0请升级）
- 查扩展是否启用：php -m | grep -E "fileinfo|mbstring|json|curl|openssl|pdo"
- Windows用户注意：php --ini确认CLI模式加载的是哪个php.ini，别只改了Apache的配置
- 若缺fileinfo，编辑php.ini取消;extension=fileinfo前的分号，保存后重启Web服务
用对命令+清理残留再重试
很多人误用composer require topthink/think，这只会把框架放进vendor，不生成app/、public/等结构，后续必报Class 'think\App' not found。
立即学习“PHP免费学习笔记（深入）”；
- 正确命令只有：composer create-project topthink/think myapp
- 安装前手动删掉项目目录下的vendor和composer.lock
- 若仍失败，加--ignore-platform-reqs临时绕过版本约束（仅用于验证能否跑通，后续需补全环境）
- 装完运行php think，能列出命令说明autoload正常；报错则说明vendor/autoload.php未加载
装完运行时报Driver [Think] not supported
这不是安装失败，是项目已建好但视图驱动缺失。TP8把think-view拆成独立包，默认不带。
- 进项目根目录（有composer.json的地方），执行：composer require topthink/think-view
- 检查config/view.php中'type' => 'Think'拼写是否正确（大小写敏感）
- 别手动复制类或改Manager.php——驱动管理器靠
class_exists()判断，没装包就真找不到
