ThinkPHP安装报错主因是环境未对齐：PHP版本需≥7.2且扩展齐全，必须切换阿里云镜像（https://mirrors.aliyun.com/composer/），清除缓存及vendor、composer.lock后重装，并确保public/index.php正确引入autoload.php。
ThinkPHP安装命令报错，绝大多数情况不是框架本身有问题，而是本地环境没对齐官方要求。直接换镜像、清缓存、确认PHP版本这三步做完，80%的报错就消失了。
php -v 显示版本但 composer create-project 仍拒绝安装
Composer 会严格校验 php 命令返回的版本号字符串，而不仅仅是数字部分。比如你看到 PHP 8.1.23，但 Composer 实际解析时可能因补丁标识（如 8.1.23-1~ubuntu22.04.1）判定不满足 ^8.1 约束。
- 运行
php -v和php --version，确认输出一致且无警告 - 检查
composer.json中topthink/framework的版本约束，例如"^6.3"要求 PHP ≥7.2 且兼容 8.x，但不支持 8.3+ 的某些破坏性变更 - 临时绕过版本检查仅用于验证：加
--ignore-platform-reqs，但装完必须立刻测试php think是否能正常列出命令，否则大概率运行时报错
composer create-project 卡在 “Downloading https://packagist.org”
这不是网络断了，是默认源在国内不可用。阿里云镜像已成事实标准，旧的 phpcomposer.com 镜像早在 2025 年底就停服了。
- 执行
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 验证是否生效：
composer config -g repo.packagist输出应为含"url": "https://mirrors.aliyun.com/composer/"的 JSON - 删掉残留的
vendor/和composer.lock，再跑安装命令——锁文件里可能存着失败时的半截依赖树
安装完运行 php think 报 Class 'think\App' not found
核心问题只有一个：入口文件没正确加载 vendor/autoload.php。ThinkPHP 6+ 不再提供可直接 require 的全局类，全靠 Composer 自动加载。
立即学习“PHP免费学习笔记（深入）”；
- 检查
public/index.php第一行是否为require __DIR__ . '/../vendor/autoload.php'; - 确认 Web 服务器 root 指向的是
public/目录，而不是项目根目录——否则index.php里的相对路径会错位 - 手动执行
composer dump-autoload -o，强制重建优化后的自动加载映射，尤其在你改过composer.json或新增了类之后
Windows 下用 Git Bash 或 WSL 执行 composer install 失败
Git Bash 和 WSL 的 shell 环境与原生 CMD/PowerShell 行为不一致，Composer 在解压 zip 或调用 git clone 时容易因路径解析或权限中断。
- 切到原生 Windows CMD 或 PowerShell 中执行安装命令
- 避免在路径中含空格或中文（如
C:\Users\张三\Desktop\tp6），换成C:\tp6这类纯英文短路径 - 如果必须用 WSL，确保挂载的 Windows 目录有执行权限：
chmod +x vendor/bin/*，否则某些二进制依赖无法运行
最常被忽略的一点：ThinkPHP 安装成功 ≠ 项目能跑起来。很多报错其实发生在第一次执行 php think 时，根源是 CLI 模式下的 php.ini 和 Web 模式不同——比如 CLI 没开 pdo 扩展，php -m | grep pdo 看不见，但 Web 页面却能连上数据库。
