正确安装tp5.1需先执行composer create-project topthink/think tp5 --prefer-dist -n，再cd tp5后运行composer require topthink/framework:^5.1 --update-with-dependencies，并验证php think version输出v5.1.xx及app/目录存在。
直接装 topthink/think 默认得到的是 TP6，不是 TP5。想用 Composer 正确安装 TP5（特指 5.1.x 稳定版），必须绕过包名陷阱、锁死内核版本、验证骨架结构。
为什么 composer create-project topthink/think 总是装错？
因为 topthink/think 这个包在 2021 年后已全面转向 TP6+，其 composer.json 中对 topthink/framework 的依赖默认指向 ^6.0。即使你加了 =5.1.*，Composer 也会因约束冲突静默跳过或降级失败。
topthink/framework:^5.1 才是 TP5.1 的真实稳定内核，但它不带 public/ 入口和 think 命令脚本——必须配合 topthink/think 的 TP5 分支骨架使用。
- 执行
composer create-project topthink/think tp5→ 得到 TP6 骨架，php think run报错或路由不生效 - 用
topthink/think=5.1.x-dev→ 可能拉到不稳定开发版，vendor/下缺失关键类 - 镜像没切回官方源（如
packagist.org）→^5.1版本根本搜不到
三步实操：正确安装 TP5.1（PHP 7.1+ / Composer 2.x）
以下命令在终端中逐行执行，无需改配置、不碰 php.ini：
- 运行
composer create-project topthink/think tp5 --prefer-dist -n（先拉 TP5 骨架） - 进入目录：
cd tp5 - 强制切换内核：
composer require topthink/framework:^5.1 --update-with-dependencies
执行完立刻检查 composer.json：里面 "topthink/framework" 的版本必须是 "^5.1"，且不能出现 "dev-master" 或 "6.x" 字样。若看到 ^6.0，删掉 vendor/ 和 composer.lock，重跑第三步。
如何验证真装的是 TP5 而不是 TP6？
别只看首页显示“ThinkPHP”，要看真实行为：
- 运行
php think version→ 输出应为v5.1.xx，不是v6.x - 运行
php think route:list→ TP5 输出表格含method、route、address三列；TP6 多一列middleware且格式不同 - 访问
http://localhost:8000/index.php/hello→ TP5 默认带index.php前缀可访问；TP6 默认关闭index.php支持，会 404 - 检查
app/目录是否存在 → TP5.1 使用app/，TP6 用app/+app/common.php拆分逻辑
后续引入扩展包（如 think-captcha）要注意什么？
在 TP5 项目里用 composer require 安装扩展，核心风险不在下载，而在加载和注册：
- 确保当前路径是项目根目录（含
composer.json和public/） - 安装后检查
vendor/topthink/下是否存在对应包，例如think-captcha - 手动打开
config/app.php，确认'providers'数组中已注册服务提供者，如think\captcha\CaptchaService::class - 部分扩展（如
think-queue）不会自动发布配置文件，需从vendor/topthink/think-queue/config/queue.php复制到项目config/目录下 - 最后执行
composer dump-autoload -o刷新自动加载映射，否则仍可能报Class not found
TP5 的兼容性断点很隐蔽：一旦 composer.json 里混入 ^6.0 依赖，或服务提供者未注册，框架表面能跑，但中间件、命令、路由等关键能力会静默失效——这点比报错更难排查。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
