ThinkPHP6是完全重写的框架，不兼容TP5，需新建项目迁移；配置改用.env和模块化config/；路由需显式启用merge_param；Db/模型返回Collection须转数组；缺失功能需安装对应扩展。
Class 'think\App' not found 或控制器全报错？这不是升级，是重装
ThinkPHP6 不是 ThinkPHP5 的升级版，而是用 PHP7.1+ 重写的全新框架。直接 composer update 不会生效，composer require topthink/framework:^6.0 也会失败——因为 TP6 根本不兼容 TP5 的命名空间和核心类结构。
必须新建项目迁移，不能原地覆盖。旧项目的 application/ 目录在 TP6 中已废弃，所有控制器、模型、中间件都得按 PSR-4 规范移到 app/ 下，并严格匹配命名空间（如 app\controller\Index）。
- 执行
composer create-project topthink/think tp6拉一个干净骨架 - 把旧项目逻辑拆解后，逐个迁入
app/目录，别复制粘贴整个application/ - 迁移后首次访问若报
Class 'think\App' not found，说明还有代码在引用 TP5 的全局类，立刻 grep 查找并替换
配置全失效？检查 .env 和 config/ 目录结构
TP5 的 config.php 单文件在 TP6 中完全不被读取。所有配置被拆进 config/app.php、config/database.php 等模块化文件，且优先级低于 .env —— 如果你没建 .env，或里面写了 APP_DEBUG=false，那即使你在 PHP 里设了 app_debug = true，调试模式也始终关闭。
-
.env文件名必须是纯.env（无后缀、无空格），放在项目根目录，内容用KEY=VALUE格式 - 数据库密码含
@、#等特殊字符时，必须用双引号包裹：DB_PASSWORD="p@ss#word!" -
config/database.php中不能再用mysql://这种连接字符串，要改写成数组格式：'hostname' => '127.0.0.1', 'database' => 'test'
Request::param() 拿不到路由参数？补上 merge_param 选项
TP5 默认合并 URL 路径、GET、POST 参数，所以 input('id') 或 $request->param('id') 总能取到值。TP6 默认只取 query + post，**不自动合并 route 变量**，导致 Route::get('user/:id', 'user/read') 迁移后 $id 始终为空。
立即学习“PHP免费学习笔记（深入）”；
- 路由定义必须显式开启合并：
Route::get('user/:id', [\app\controller\User::class, 'read'])->option(['merge_param' => true]) - 或者改用资源路由：
Route::resource('user', 'User');，它默认启用merge_param - 旧代码中依赖
input('id')的地方，统一改为$request->param('id')并确认路由是否带该选项
Db::name('user')->select() 返回对象？别忘了 ->toArray()
TP6 的 Db::select() 和模型 find()/select() 全部返回 Collection 对象，不再是数组。直接 foreach 或 json_encode 会出错或输出意外结构，比如 Call to undefined method think\Collection::toArray() 是因版本太低，但更常见的是返回 JSON 后前端收不到 data 字段。
- 显式转数组：
Db::name('user')->select()->toArray()或$users->toArray() -
whereTime()、whereLike()等快捷方法已从核心 Query 类移出，需安装扩展：composer require topthink/think-helper，再use think\helper\Query; - 模型查询取消了
get()、all()、getOrFail()等方法，统一用find()/select()，且必须处理返回类型
最常被忽略的一点：TP6 默认不开启 Session，也不自带模板引擎和多应用支持。哪怕你只是想让 fetch() 正常工作，或让 app/admin 路由不 404，都得手动装 topthink/think-view 和 topthink/think-multi-app —— 这些不是可选，是刚需。
