ThinkPHP8安装报错90%以上是环境或镜像问题，非框架bug；常见错误如依赖解析失败、超时、Driver[Think] not supported等，均可5分钟内定位解决。
直接说结论：ThinkPHP8安装命令报错，90%以上是环境或镜像问题，不是框架本身有bug。 常见错误如 Your requirements could not be resolved to an installable set of packages、Connection timed out、Driver [Think] not supported，基本都能在5分钟内定位并解决。
composer create-project 执行中断没生成 vendor
这是最典型的“假失败”——命令卡住或被 Ctrl+C 中断后，vendor 文件夹确实不会创建，后续任何 composer update 或 composer install 都会报依赖解析失败。
- 别急着删项目重来，先检查当前目录下是否有
composer.json（哪怕不完整） - 执行
composer clear-cache清掉可能损坏的缓存 - 换国内镜像源：运行
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 再试一次
composer install --ignore-platform-reqs（仅临时用，确认能跑通再删掉这个参数） - 如果仍失败，检查 PHP 版本是否 ≥7.3：
php -v；缺fileinfo扩展也会静默中断，用php -m | grep fileinfo确认
报错 Driver [Think] not supported
这不是安装失败，而是运行时报的错，说明项目结构已建好，但视图驱动缺失。ThinkPHP8 把 think-view 拆成独立包，新项目默认不带它。
- 进项目根目录（有
composer.json的地方），运行composer require topthink/think-view - 不要手动复制类文件或改配置绕过——驱动管理器（
Manager.php）靠class_exists()检查类是否存在，没装包就真找不到think\View\Driver\Think - 如果装完还报错，检查
config/view.php里'type' => 'Think'是否拼写正确，大小写敏感 - 注意：TP5 升级到 TP8 时，这个包必须显式安装，不能依赖旧配置残留
PHP 扩展缺失导致的静默失败
某些扩展缺失不会直接报错，但会让 Composer 在解包或 autoload 阶段崩溃，表现为“无输出”“卡住”或最终提示 failed to open stream。
立即学习“PHP免费学习笔记（深入）”；
- 必须开启的扩展：
fileinfo（解压 zip 包必需）、mbstring（字符串处理）、json、curl、openssl - 检查命令：
php -m，看列表里有没有fileinfo；没有就编辑php.ini，取消;extension=fileinfo前的分号 - Windows 下常见问题是
php_pdo_mysql.dll没启用，报错类似Fatal error: Class 'PDO' not found，同样要去php.ini开启 - 改完
php.ini后，CLI 和 Web 服务器用的是不同配置文件，记得用php --ini确认 CLI 加载的是哪个
open_basedir 或权限限制导致的路径错误
尤其在 WAMP/XAMPP 环境下，require(D:\wamp\www\thinkphp\index.php) 报错“failed to open stream”，往往不是路径写错，而是 PHP 被 open_basedir 锁死了访问范围。
- 运行
php -i | grep open_basedir查看当前限制值 - 修改
php.ini，把项目路径加进去，例如：open_basedir = "D:/wamp/www;D:/wamp/www/tp8" - 或者在 Apache 的
httpd.conf里对项目目录单独放开：php_admin_value open_basedir "D:/wamp/www/tp8" - Linux 下注意 SELinux 或 AppArmor 也可能拦截文件访问，先临时禁用测试是否为权限问题
真正麻烦的从来不是报错信息本身，而是错误发生的位置——Composer 安装阶段出问题，和运行时报 Driver not supported，根本不是一个层面的事。前者查环境与网络，后者查依赖与配置。漏掉任意一个环节（比如只配了 Web 服务器的 php.ini，忘了 CLI 的），问题就会反复出现。
