ThinkPHP 8.0安装失败主因是环境不匹配、依赖未就绪或配置被绕过；需确认PHP≥8.0且启用fileinfo/mbstring/pdo/json等扩展，换阿里云镜像，清缓存，确保Web服务器指向public目录，并检查runtime权限与BOM污染。
ThinkPHP 8.0 安装总报错，核心问题不在命令写错，而在于环境不匹配、依赖未就绪或配置被绕过。直接执行 composer create-project topthink/think myapp 却失败，大概率卡在底层条件上。下面分四类高频场景，逐个击破。
PHP版本和扩展没达标
TP8.0 要求 PHP ≥ 8.0.0，且必须启用 fileinfo、mbstring、json、pdo、openssl 等扩展。 - 运行 `php -v` 确认版本是否 ≥ 8.0 - 运行 `php -m | findstr -i "fileinfo mbstring pdo json"`（Windows）或 `php -m | grep -E "fileinfo|mbstring|pdo|json"`（Linux/macOS），检查关键扩展是否列出 - 若缺失：打开 `php --ini` 显示的 php.ini 文件，取消对应行前的分号，例如： ;extension=fileinfo → extension=fileinfo - 修改后重启 Web 服务（Apache/Nginx）或关闭所有终端重开 PowerShell/CMD，再试安装Composer 依赖解析失败
报错信息含 “Your requirements could not be resolved” 或 “Cannot use topthink/think’s latest version v8.0.0 as it requires php >=8.0.0”： - 先确认当前终端调用的 PHP 真是 8.0+：运行 `where php`（Windows）或 `which php`（macOS/Linux），看路径是否指向新版 PHP 目录 - 若存在多个 PHP 版本，把新版路径（如 `C:\php-8.2.5`）移到系统 PATH 最前面 - 清理 Composer 缓存：`composer clear-cache` - 尝试指定版本安装：`composer create-project "topthink/think:^8.0" myapp` - 临时绕过平台检查（仅调试用）：`composer create-project topthink/think myapp --ignore-platform-reqs`Web服务器根目录配错，导致访问即 500/404
安装成功但浏览器打开白屏或报错，常因入口路径不对： - Apache 用户：虚拟主机 `DocumentRoot` 必须指向项目内的 `public/` 目录，不是项目根目录 - Nginx 用户：`root` 指令应设为 `/path/to/myapp/public`，而非 `/path/to/myapp` - 同时确保 `.htaccess`（Apache）或 `try_files`（Nginx）规则生效，否则路由无法转发到 `public/index.php`runtime 目录权限或 BOM 污染触发静默失败
即使安装完成，首次运行 `php think run` 或访问页面仍报错（如 Class 'think\App' not found），往往因： - `runtime/` 及其子目录（`log/`、`cache/`、`view/`）不可写：手动创建并赋权，例如 Windows 下右键属性→安全→编辑→添加 IIS_IUSRS 或 Users 的完全控制权限 - 配置文件（如 `config/app.php`）被记事本保存为 UTF-8 with BOM：改用 VS Code、Notepad++ 等工具另存为 UTF-8（无 BOM）格式 - `env` 文件存在非法字符或换行符：删掉空行、全角符号，确保 `APP_DEBUG=true` 等键值对格式规范不复杂但容易忽略
