装错版本是thinkphp启动失败最常见原因：composer create-project未指定版本时会静默降级（如php 7.4环境装tp6而非tp8），导致php版本不匹配、class not found等错误；必须用带引号的约束符硬控版本，如"topthink/think:^8.0"，并用php think version和installed.json验证实际安装版本。
装错版本是 ThinkPHP 项目启动失败最常见原因，不是代码写错了，而是 composer require 或 create-project 没锁准版本号。直接后果：PHP 版本不匹配、类找不到、服务提供者注册失败、甚至 php think version 都报错。
composer create-project 装错版本的典型表现
执行 composer create-project topthink/think tp 后，tp/vendor/topthink/framework 下的版本可能是 v8.x（PHP 8.1+）或 v6.x（PHP 7.2+），完全取决于你当前 php -v 输出的版本和 Composer 的解析逻辑——它不会猜你要什么版本。
- PHP 8.2 环境下运行该命令，默认拉 v8.0，但若系统 PATH 里实际是 PHP 7.4，就会静默降级装 v6.3
- Windows 下 phpEnv 用户尤其容易中招：控制台显示启用了 PHP 8.2，但 cmd 中
php -v仍是 7.4 —— 环境变量没刷进去 - 装完发现
php think run报Class 'think\App' not found，大概率是框架主包版本和 PHP 实际版本错配
明确指定 ThinkPHP 版本的安装命令
不依赖环境自动推断，用约束符硬控版本。关键不是“怎么装”，而是“怎么让 Composer 只装你要的那个”：
- 要 ThinkPHP 6.1.0（PHP ≥ 7.2）：
composer create-project "topthink/think:6.1.0" tp6 - 要 ThinkPHP 6.3.x（兼容 PHP 7.2–8.0）：
composer create-project "topthink/think:^6.3" tp6 - 要 ThinkPHP 8.0.x（必须 PHP 8.1+）：
composer create-project "topthink/think:^8.0" tp8 - 已存在项目想降级到 6.1.0：
composer require "topthink/think:6.1.0" --update-with-dependencies，再删vendor/topthink和composer.lock中相关行后composer install
注意："topthink/think:^6.3" 的引号不能省，否则 shell 会把 ^ 当作命令符处理。
装完怎么验证版本是否真对上了
别只看目录名或 README，得查真实加载的代码版本：
- 执行
php think version，输出应为类似v6.3.10或v8.0.2 - 打开
vendor/composer/installed.json，搜索topthink/think，确认version字段值与预期一致 - 检查
composer.json中"topthink/think"行的约束是否是你手动写的，而不是自动生成的^8.0.0这类宽泛表达 - 如果用的是 TP6，还要顺手跑
php think queue:listen测试队列包是否兼容——topthink/think-queue:^3.0才配 TP6，^4.0是给 TP8 准备的
版本选择不是选最新，而是选和你 php -v、扩展、以及已有代码耦合度最低的那个。很多线上问题，根源就卡在 composer.json 里一行没加引号的 ^6.1 上。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
