ThinkPHP安装失败主因是环境不匹配或操作错误：需PHP≥7.2并启用json、mbstring等扩展；必须切换阿里云镜像源；删vendor和composer.lock再install；确保public/index.php正确引入autoload且访问public目录。
ThinkPHP 安装失败，90% 不是框架问题，而是环境没对齐或操作顺序错了。 直接删 vendor 和 composer.lock 再重试，大概率能过。下面分几种典型场景说清楚怎么做、为什么、容易卡在哪。
PHP 版本和扩展不满足就别硬装
ThinkPHP 6+ 明确要求 PHP ≥ 7.2，且必须启用 json、mbstring、xml、curl、openssl 这几个扩展。报错像 your PHP version does not satisfy that requirement 或 ext-json missing，就是这个原因。
- 运行
php -v确认版本，低于 7.2 就得先升级 - 运行
php -m检查扩展列表，缺哪个就去php.ini里开哪个（Windows 是extension=php_curl.dll，Linux/macOS 是extension=curl） - 特别注意：WAMP/XAMPP 的 Web 环境和命令行（CLI）用的可能是两套
php.ini，用php --ini看 CLI 加载的是哪个文件
composer install 卡住或超时，镜像源没切对
默认连 packagist.org 在国内基本走不通，不是网络断了，是连接慢 + 下载超时反复重试。现象是卡在 Installing dependencies 或报 Connection timed out。
- 执行
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/切阿里云镜像（别用已停用的phpcomposer.com） - 验证是否生效：
composer config -g repo.packagist输出里要有"url": "https://mirrors.aliyun.com/composer/" - 如果之前失败过，删掉项目根目录下的
vendor/和composer.lock再跑composer install—— 否则 Composer 会按 lock 文件硬拉旧版依赖，哪怕composer.json已改
安装完访问报 Class 'think\App' not found
这不是没装成功，是入口或自动加载断了。ThinkPHP 6+ 的核心类不靠手动 require，全靠 Composer 的 autoload 机制注入。
立即学习“PHP免费学习笔记（深入）”；
- 确认
public/index.php第一行是require __DIR__ . '/../vendor/autoload.php'; - 浏览器必须访问
public/目录，不能直接访问项目根目录（比如http://localhost/tp6错，http://localhost/tp6/public/对） - 命令行进项目根目录跑
php think，能输出命令列表才说明 autoload 生效；如果报错，检查vendor/autoload.php是否真实存在、路径是否被 open_basedir 限制
Windows 下 composer create-project 卡死不动
常见于 Git Bash、WSL 或 Cygwin 环境下执行，Composer 启动的子进程（比如解压 zip、调用 git clone）在兼容层里权限或路径解析异常。
- 关掉所有终端，只用 Windows 原生 CMD 或 PowerShell 重试
- 别用 WSL 的 PHP 或跨环境混用 Composer
- 如果仍卡在
The Process class relies on proc_open，检查php.ini里disable_functions是否禁用了proc_open，删掉它再重启 PHP
最常被忽略的一点：ThinkPHP 6+ 的 vendor/topthink/framework/src 里没有直接可 require 的 App.php 入口，它靠服务提供者注册和 Composer 自动加载联动。所以别翻 vendor 找文件，要看 php think 和入口文件的 autoload 是否通——通了，框架就在；不通，八成是上面四点中某一个没对上。
