手册是工具参考而非教程，需先学《5.0快速入门》再查手册；用搜索框精准定位功能；示例代码需自行补全上下文；配置、数据库连接和模板调试三处易失效。
想靠翻ThinkPHP 5.0官方手册入门框架却卡在“看不懂目录结构、找不到对应功能说明、查到的代码跑不起来”这三关？这不是你理解力的问题，是手册本身定位就是工具参考而非教学材料。
先搞清手册不是教程
官方明确说明：“本手册不能替代教程，而是作为工具参考”。它不教你怎么搭第一个控制器，不带你写第一行路由规则，也不解释Db::name('user')->select()里name()到底干啥——这些必须去《5.0入门系列教程》学。手册只回答“这个方法参数怎么填”“那个配置项在哪生效”“异常类名是什么”。【跳过入门教程直接啃手册，等于没带地图进迷宫】
如果你刚接触TP5，现在立刻关掉手册网页，打开《5.0快速入门》PDF或视频，从“安装→目录结构→第一个Hello World”开始。等你用php think run跑出页面、知道app/index/controller/Index.php改哪能变文字，再回头查手册才有效率。
查功能：用搜索框比翻目录快10倍
手册首页顶部有全局搜索框，输入关键词就能直达章节。比如搜“验证”，直接跳转到《验证》章节；搜“分页”，精准定位Paginator类文档；搜“中间件”，连注册方式和执行顺序都列得清清楚楚。
立即学习“PHP免费学习笔记（深入）”；
别信左侧目录树——它按模块粗略分类，但实际开发中你根本不会按“数据库→模型→关联→查询语言”这种逻辑找问题。用户登录失败？搜“Auth”或“session”；上传图片报错？搜“upload”或“file”；接口返回空数组？搜“json”或“response”。【搜索词越贴近你报错信息或需求描述，结果越准】
看代码：所有示例默认省略了上下文
手册里的代码片段全是“裸代码”：没有use语句，不写namespace，不提该放在控制器还是模型里。比如看到$user = User::get(1);，你得自己补上use app\model\User;；看到Route::get('hello','index/hello');，得知道这行要写在route/route.php里。
遇到运行报错，先确认三件事：① 类是否已引入（查命名空间声明）；② 方法是否在当前版本存在（V5.0.24是最终维护版，新特性手册不收）；③ 配置是否启用（如路由需开启url_route_on）。手册不提这些，但它们决定代码能不能活。
避坑：三个高频失效点
方法一：查“配置”章节却配不生效
手册写的app.php配置项，实际要写进app/config/app.php文件。但如果你用环境变量配置（.env），手册里app_debug的说明就不管用——.env里得写APP_DEBUG=true，大小写和等号都不能错。
方法二：复制“数据库连接”示例连不上
手册给的'type' => 'mysql'只是示意，真实项目必须填全hostname、username、password、database四项，缺一不可。本地测试用127.0.0.1，上线必须换localhost或真实IP，手册不会提醒这点。
方法三：按“模板引擎”章节改{:date('Y-m-d')}没反应
这是因为模板调试模式默认关闭，错误被静默吞掉。手册没写，但你得手动打开app_debug => true，才能看到语法错误提示。不打开，只会渲染出空白页。
