要快速查清ThinkPHP 6.0功能用法，须按开发流程定位手册章节：先「基础」→ 再「核心」→ 后「扩展」；查事务进「数据库→事务控制」，查验证进「请求与响应→验证」；控制器需手动调用validate()；配置以.env为准，注意DB_HOST、APP_DEBUG、CACHE_OFF设置及runtime/cache清理；模型报错查第5章异常映射表；路由需同时满足route/app.php定义、控制器存在且命名正确、URL省略index.php；调试开启APP_TRACE=true查看SQL与路由详情。

要快速查清ThinkPHP 6.0中某个功能的用法、参数含义或底层行为，不能靠猜命名或翻源码。

最新手册不是词典式罗列，而是按开发动线组织的实操指南。

必须先知道从哪一页切入、怎么跳转，以及哪些章节要配合阅读。 否则很容易踩坑。

先判断功能属于哪个模块

打开 https://www.kancloud.cn/manual/thinkphp6_0（最新中文手册）后，先要注意一件事：首页左侧导航并不是按字母顺序排的。

它是按照实际开发流程来分层的，阅读路径基本就是「基础」→「核心」→「扩展」。

如果要查“数据库事务怎么回滚”，不要一上来就盯着“事务”这个词搜。

正确的找法是先进入「数据库」这个大类，再继续定位到子项「事务控制」。

如果想弄清楚“表单提交后如何验证数据”，就应该进入「请求与响应」→「验证」。

不要跑去「模型」里来回翻。

所有控制器方法默认不校验输入，【必须手动调用 validate() 或使用 validate 场景】，否则用户传任意字符串都能进业务逻辑。

查配置项时，优先看 .env

手册里 config/database.php 的字段说明只是参考模板。

实际生效的是项目根目录下的 .env 文件。

编辑 .env 时要注意的3件事

• DB_HOST 不能写 localhost（Docker 环境会解析失败，得写 host.docker.internal）；
• APP_DEBUG=true 才能触发错误堆栈；
• CACHE_OFF=true 仅用于调试，上线前必须删掉这行。

修改 .env 后无需重启服务。

但如果 runtime/cache 目录下已有路由缓存，新配置不会立即生效。

这时需要删掉 runtime/cache/ 下所有文件，再刷新页面。

模型查询报错时，先看第5章异常映射表

手册第 5 章结尾专门放了一张「常见 PDO 异常代码与解决方案」表。

实际使用时，这张表往往比直接看 PHP 的报错提示更容易定位问题。

常见报错判断

• 如果遇到 SQLSTATE[HY000] [1045] Access denied，通常意味着 .env 里的 DB_USERNAME 或 DB_PASSWORD 填错了；
• 如果报的是 SQLSTATE[42S02] Base table or view not found，那多半是模型类中的 $table 属性没有设置正确，当然，也不排除数据库里本来就没有这张表。

两种排查方法

• 方法一：查手册搜索框输入「1045」，直接跳转到异常说明页。
• 方法二：在 app/model/User.php 中写 die(get_class($this)); 确认当前模型是否被正确实例化，避免因命名空间拼错导致 new User() 返回 null。

路由定义必须同时匹配三处

• 第一步：确认 route/app.php 里写了 Route::get('user/:id', 'user/read');
• 第二步：检查 app/controller/User.php 是否存在且类名为 class User extends thinkController；
• 第三步：打开浏览器访问 http://localhost/user/123，而非 http://localhost/index.php/user/123 —— 【public 目录是唯一 Web 入口，所有 URL 必须省略 index.php】。

如果页面空白但控制台无报错，立刻检查 runtime/log/ 下最新日志文件。

90% 是路由未注册，或控制器方法名带下划线（如 _init）导致框架跳过执行。

调试模式下开启 trace 面板

在 .env 中设置 APP_TRACE=true。

浏览器底部会出现 ThinkPHP 调试工具条。

• 点击「SQL」标签页，能看到本次请求所有执行过的 SQL 语句及耗时；
• 点击「Route」可验证当前 URL 是否命中你写的路由规则。

这个面板只在 APP_DEBUG=true 且 APP_TRACE=true 时显示。

生产环境严禁开启。