ThinkPHP环境搭建报错90%源于环境未对齐或操作顺序错误：需严格匹配PHP版本与扩展、正确执行composer安装命令、清理镜像源与缓存、清空runtime缓存并确保.env编码无BOM。
ThinkPHP项目环境搭建报错，90%不是框架问题，而是环境没对齐或操作顺序错了。关键不在“装得多快”，而在“每一步是否踩准节点”。下面直说最常卡住的几个环节，以及怎么绕过去。
PHP版本和扩展必须一次配齐
ThinkPHP 6要求PHP ≥7.2.5，TP8强制要求≥8.0——但光看主版本号不够。比如PHP 8.0.0～8.0.4存在opcache bug，会导致自动加载失败、页面白屏；PHP 8.2+则必须启用mbstring、curl、openssl、PDO、json、xml、fileinfo全部扩展，缺一个，composer install就静默跳过核心包。
- 执行
php -v确认完整版本号（含补丁号），不是只看“8.0” - 运行
php -m | grep -E 'mbstring|curl|pdo|fileinfo'检查扩展是否真实加载 - 特别注意：CLI环境和Web环境可能用不同php.ini，用
php --ini查CLI实际加载路径
安装命令和目录位置不能错
不是“装上就行”，而是“在哪装、怎么装”决定后续能不能跑通。常见错误是把项目建在桌面或Downloads里，结果Web服务器根本找不到入口；或者在public目录里执行create-project，直接覆盖掉index.php。
- 先创建空目录，
cd进去，再运行composer create-project topthink/think .（末尾是点，表示当前目录） - 务必在Web服务器根目录下操作，比如
/var/www/html或XAMPP/htdocs，否则Apache/Nginx无法正确解析public/路径 - Windows用户避免用Git Bash或WSL，改用CMD或PowerShell，防止proc_open调用异常
镜像源、缓存、残留文件要同步清理
Composer卡在“Downloading”或报Connection timed out，基本就是镜像源没切对；装完访问报Class 'think\App' not found，大概率是vendor/autoload.php没被正确引入，或是缓存没清干净。
立即学习“PHP免费学习笔记（深入）”；
- 执行
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/切阿里云镜像 - 删掉项目根目录下的
vendor/和composer.lock，再跑composer clear-cache - 确认
public/index.php第一行是require __DIR__ . '/../vendor/autoload.php'; - 浏览器必须访问
http://localhost/your-project/public/，不能访问项目根目录
.env配置生效前必须清runtime缓存
改完数据库地址、APP_DEBUG=true或JWT密钥后刷新页面没反应？不是配置没写对，而是ThinkPHP把.env内容编译进了runtime/cache/里的PHP文件里，不删缓存，改了也白改。
- 进入项目根目录，运行
php think clear，它会自动清空runtime下所有子目录 - 检查
.env是否UTF-8无BOM编码（Windows记事本保存默认带BOM，会导致框架读不到） - 确认
.env和think可执行文件同级，不在public/或app/下
