ThinkPHP安装报错主因是环境、镜像或残留文件问题：需删除vendor和composer.lock、清缓存、切阿里云镜像、用create-project命令安装，并确保public/index.php正确引入autoload.php且访问路径指向public目录。
Composer安装ThinkPHP报错，90%不是命令写错了，而是环境、镜像或残留文件在“拖后腿”。不用重装PHP、不用删整个项目，按这几步操作，5分钟内基本能跑通。
先清缓存和残留文件
vendor目录和composer.lock是“旧规则”的载体，不清理就容易卡在版本冲突或路径错误上。
- 删除项目根目录下的 vendor/ 文件夹和 composer.lock 文件
- 运行 composer clear-cache 清掉本地缓存（尤其之前换过镜像或失败过多次）
- Windows用户注意：别用Git Bash或WSL执行，改用CMD或PowerShell，避免proc_open调用异常
确认PHP环境达标
ThinkPHP 6要求PHP ≥ 7.2.5（推荐≥7.4），TP8则需≥8.0；缺扩展比版本低更隐蔽，常静默失败。
- 运行 php -v 查版本
- 运行 php -m | grep -E "(json|mbstring|xml|curl|openssl|phar|zlib)"（Linux/macOS）或 php -m（Windows）确认关键扩展已启用
- Windows用户务必执行 php --ini，看CLI模式加载的是哪个php.ini，别只改了Apache的配置
切阿里云镜像并用对命令
国内直连packagist.org基本不可用，“Connection refused”“timeout”“could not find package”八成是镜像没切对。
立即学习“PHP免费学习笔记（深入）”；
- 全局设置镜像：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
- 验证是否生效：composer config -g repo.packagist 输出应含该URL
- 安装必须用 composer create-project topthink/think project-name（TP6/TP8都适用）
别用composer require topthink/think——它只会把框架代码放进vendor，不生成app/、public/等结构，后续必报Class 'think\App' not found
装完访问仍报错？检查入口和自动加载
安装成功≠能运行。常见问题集中在入口路径错、autoload没引入、或命名空间映射丢失。
- 打开 public/index.php，第一行必须是：
require __DIR__ . '/../vendor/autoload.php';（少一个点或多一个斜杠都会失效） - 运行 php think，能输出命令列表说明autoload正常；报错则说明vendor/autoload.php未被正确加载
- 确认访问的是 http://your-domain.com/public/index.php，不是根目录或错把index.php移到根下
- 若扩展装完提示Class not found，运行 composer dump-autoload -o 强制重建自动加载映射
