ThinkPHP无运行时版本切换，需修改composer.json版本约束并执行composer update，同时必须适配架构变更：TP8移除thinkApp类，入口改用app()->run()->send()，配置加载、命令类继承及autoload隔离均需同步调整。
ThinkPHP 没有“安装命令切换版本”这回事——composer create-project 或 composer require topthink/framework 本身不提供运行时版本切换能力，它只负责按你指定的版本号拉取并锁定依赖。真正在项目中“切换版本”，本质是修改 composer.json 中的框架版本约束，再执行 composer update 重装依赖，同时必须同步处理架构变更带来的代码适配问题。
如何用 Composer 指定 ThinkPHP 版本安装
新建项目时，直接在 create-project 命令末尾写明版本号（支持稳定版、分支别名、开发快照）：
-
composer create-project topthink/think myapp "8.0.*"→ 安装 TP8 最新 8.0.x 小版本 -
composer create-project topthink/think myapp "6.1.*"→ 安装 TP6.1 系列 -
composer create-project topthink/think myapp dev-main→ 安装开发中的主干分支（不建议生产）
注意："8.0.*" 这类写法依赖 composer.json 中 minimum-stability 设置为 stable（默认），若设为 dev 可能意外装到 alpha 版。
升级现有项目时，composer update 必须配合手动代码迁移
仅改 composer.json 里的 "topthink/framework": "^8.0" 并运行 composer update topthink/framework 是不够的。TP6 升到 TP8 会立刻报错：Class 'thinkApp' not found。
立即学习“PHP免费学习笔记（深入）”；
- 入口文件
public/index.php中的App::run()->send()必须改为app()->run()->send()或thinkcadeApp::run() -
config('database')在 TP8 默认返回空数组，需先确保app()->loadConfig()已调用，或改用app('config')->get('database') - 所有自定义命令类要从继承
thinkConsoleCommand（TP6）改为thinkconsoleCommand（TP8，注意命名空间大小写） - TP8 默认禁用
vendor/bin/think全局命令别名，得用php think make:command Xxx生成新结构
共存多个 ThinkPHP 版本项目，关键在 vendor 隔离与 autoload 冲突预防
同一台服务器上跑 TP6 和 TP8 项目，最常踩的坑不是 PHP 版本，而是 Composer 自动加载污染：
- 绝对不要软链共用
vendor/目录——每个项目必须独立执行composer install - 检查各项目
composer.json的autoload.psr-4，避免前缀重叠，例如两个项目都写了"app\": "app/"或"top\": "src/" - 部署时加
--no-dev --optimize-autoloader，减少未声明类被意外加载的概率 -
composer.lock必须提交进 Git，它是多环境行为一致的唯一保障，尤其当团队混用 PHP 8.1 / 8.2 时
真正麻烦的从来不是命令怎么敲，而是 TP6 到 TP8 这类大版本跃迁后，app() 从静态代理变成容器实例、配置加载时机变化、命令系统重构这些底层契约的断裂。没做代码层适配就强行 update，只会让错误堆在运行时爆发，而不是在 composer 阶段提示你。
