ThinkPHP开发环境搭建核心是装对PHP、用对Composer、项目放对位置；需确认PHP≥8.0并启用mbstring等扩展，配置Composer国内源，新建纯英文路径执行composer create-project topthink/think .并php think run启动。
ThinkPHP开发环境搭建，核心就三件事：装对PHP、用对Composer、项目放对位置。只要这三点没出错，5分钟内就能看到欢迎页。
确认PHP版本和必需扩展
ThinkPHP 8.0要求PHP ≥ 8.0，6.x推荐PHP 7.4或8.2+。打开命令行执行：
- php -v —— 看版本号，低于8.0必须升级
- php -m | findstr "mbstring openssl pdo_mysql fileinfo"（Windows）或 php -m | grep -E "mbstring|openssl|pdo_mysql|fileinfo"（Linux/macOS）—— 检查关键扩展是否启用
若缺失，编辑php.ini，取消对应extension前的分号；改完重启终端再验证。
安装并配置Composer
Composer是安装ThinkPHP的唯一标准方式。官网下载安装器后，在命令行运行：
立即学习“PHP免费学习笔记（深入）”；
- composer --version —— 确认安装成功
- composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ —— 切换国内源，避免卡在下载环节
如果提示“找不到指定模块”，大概率缺VC++运行库（Windows）或libzip（Linux），按系统补全即可。
创建项目并启动服务
新建一个纯英文、无空格、无中文的文件夹（如D:\tp8），进入后执行：
- composer create-project topthink/think . —— 注意末尾的英文句点，表示当前目录
- php think run —— 启动内置服务器（默认http://127.0.0.1:8000）
浏览器打开地址，出现ThinkPHP欢迎页即成功。若打不开，先检查路径是否含中文/空格，再确认php think run是否真在项目根目录（有think文件的那个目录）下执行。
常见失败原因直击
90%的“环境启动失败”其实只因三处细节出错：
- 路径含中文或空格 —— Composer和PHP内部路径解析会崩，必须用C:\tp8、D:\myapp这类路径
- public目录没设为Web根目录 —— 用Apache/Nginx部署时，DocumentRoot或root必须指向project/public，不是项目根目录
- 伪静态规则错用 —— ThinkPHP需专用重写规则（如Nginx里rewrite ^(.*)$ /index.php?s=$1 last;），套Laravel或WordPress规则必然404
