ThinkPHP 8.0安装失败主因是环境未配对：须依次验证PHP版本与php.ini匹配、fileinfo/mbstring/openssl/pdo四扩展真实启用、项目在Web根目录初始化、.env修改后执行php think clear清缓存。
ThinkPHP 8.0 安装失败，90%不是代码问题，而是环境没配对——php -v 显示 8.2 不代表扩展真加载了，composer create-project 成功也不代表能访问 /public/index.php。必须按顺序验证四件事：PHP 版本与配置文件匹配、关键扩展真实启用、项目在 Web 根目录下初始化、.env 修改后清缓存。
php --ini 和 php -m 必须同时验证
很多人只跑 php -v 就以为万事大吉，结果 composer create-project 静默失败或后续报 Class 'think\App' not found。这是因为 PHP CLI 和 Web 服务（如 Apache/Nginx）可能加载了不同的 php.ini 文件。
- 先执行
php --ini，确认Loaded Configuration File指向你修改过的那个php.ini（不是php.ini-development） - 再执行
php -m | grep -E "fileinfo|mbstring|openssl|pdo"（Linux/macOS）或php -m | findstr "fileinfo mbstring openssl pdo"（Windows），四项必须全在输出里 - Windows 下扩展名必须是
.dll（如extension=fileinfo.dll），Linux/macOS 必须是.so；写错后缀，扩展永远不生效 - 改完
php.ini后，**必须重启终端 + 重启 Web 服务**，旧终端不会自动加载新 PATH 或新配置
composer create-project 必须在空目录 + Web 根目录下执行
ThinkPHP 8.0 的入口强制落在 public/ 子目录，如果项目建在桌面或 D:\Downloads，再用 Apache 指向整个项目根目录，所有请求都会绕过路由，直接 404 或暴露 app/ 目录。
- 新建一个**纯英文、无空格、无中文**的空文件夹（如
D:\tp8或/var/www/tp8） - cd 进该目录后，执行
composer create-project topthink/think .（注意末尾是英文句点.，不是省略号） - 不要用
composer require topthink/think—— 它只拉核心包，缺public/、think命令行入口、默认路由配置，必报错 - 国内用户务必提前执行
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，否则下载卡死或解压失败
Web 服务器必须指向 public 目录并启用伪静态
Apache/Nginx 若把网站根目录设在项目顶层（如 /www/wwwroot/tp8），浏览器访问域名时会直接列出目录，或返回 404；设对 /public 后若没配伪静态，/index/user 这类 URL 会 404，只有 /index.php?s=/index/user 能通。
立即学习“PHP免费学习笔记（深入）”；
- Apache：确认
.htaccess在public/下存在，且主配置中AllowOverride All已启用 - Nginx：站点配置中
root必须指向/path/to/public，且location /块内含try_files $uri $uri/ /index.php?s=$uri&$args; - 宝塔用户：【网站设置】→【网站目录】→【运行目录】填
/public；【伪静态】选thinkphp；【防跨站】必须关闭 - 本地开发可跳过这步：进项目根目录执行
php think run，它会自动用public/为文档根目录
.env 修改后不执行 php think clear = 白忙活
ThinkPHP 8 缓存机制极强：.env 里改了数据库密码、关了 APP_DEBUG，但 runtime/cache/ 里还存着旧配置的编译结果，请求照样连错库或继续暴露错误堆栈。
- 每次修改
.env后，必须进项目根目录执行php think clear - 等效手动操作：删掉
runtime/cache/、runtime/log/、runtime/container/全部内容（保留目录结构） - 上线前务必检查
runtime/目录权限：Linux/macOS 执行chmod -R 755 runtime/，Windows 确保IIS_IUSRS或www-data有写入权 -
APP_DEBUG=true只应在开发阶段开启；线上环境必须设为false并删掉.env里的敏感字段（如数据库密码），否则可能被扫描到
最常被跳过的其实是「改完 php.ini 没重启终端」和「.env 改了但忘了 php think clear」——这两步无声无息，却让前面所有操作全部失效。
