必须装PHP 8.0+（NTS/x64）、启用mbstring/openssl/pdo_mysql/fileinfo扩展、Web服务根目录指向public；三者缺一不可，否则报ParseError、类找不到或404。
想跑通第一个ThinkPHP项目，不需要懂服务器原理，但必须做对三件事：装对PHP版本、启用关键扩展、让Web服务指向public目录。其他步骤都可以简化或跳过，这三步错了，后面全白忙。
PHP 8.0+ 安装与验证（不是“有PHP就行”）
ThinkPHP 8 强制要求 PHP ≥ 8.0.0，低版本会直接报 ParseError 或找不到类。别只看 php -v 输出，要确认：
- 下载非线程安全（NTS）版 ZIP 包，例如
php-8.2.12-nts-Win32-vs16-x64.zip，解压到纯英文路径（如C:\php8） - 把该路径加进系统
PATH，然后新开命令行窗口执行php --ini，确认Loaded Configuration File指向你修改的php.ini（不是php.ini-development） - 编辑
php.ini，取消以下四行前的分号：extension=mbstringextension=opensslextension=pdo_mysqlextension=fileinfo - 保存后执行
php -m | findstr "mbstring openssl pdo fileinfo"（Windows）或php -m | grep -E "(mbstring|openssl|pdo|fileinfo)"（Mac/Linux），四项必须全部出现
用 Composer 创建完整项目结构
别用 composer require topthink/think，它只拉代码不建骨架，必报 Class 'think\App' not found。正确做法是：
- 新建一个空文件夹，路径全英文、无空格（如
D:\tp8demo） - 进入该目录，执行：
composer create-project topthink/think .（注意末尾是英文句点.，不是省略号） - 国内用户先换镜像提速：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 完成后检查目录：必须有
app/、public/、think文件、vendor/—— 缺一不可
启动服务并确认入口正确
ThinkPHP 是单入口框架，public/index.php 是唯一合法入口。映射错位置，轻则白屏，重则泄露配置文件。
立即学习“PHP免费学习笔记（深入）”；
- 在项目根目录（含
think文件的目录）下执行：php think run - 浏览器访问
http://127.0.0.1:8000，看到 “ThinkPHP V8.x” 欢迎页才算成功 - 如果 404 或空白：检查是否在根目录执行命令、
public/index.php是否存在、.env中APP_DEBUG=true是否开启 - Apache/Nginx 用户注意：
DocumentRoot或root必须指向/path/to/project/public，不能是项目根目录
不复杂但容易忽略。
