ThinkPHP 5.1手册需按“查语法→验参数→核上下文”三步精准查阅，务必确认框架版本为5.1.x，注意WHERE条件不自动过滤软删除、链式调用顺序严格（order和field须在paginate前）、关联需显式指定外键、调试应依赖getLastSql验证真实SQL。
ThinkPHP 5.1手册不是翻着看的，而是遇到具体问题时按“查语法→验参数→核上下文”三步定位，否则容易被过时示例误导、被默认配置绕晕、被链式调用顺序卡死。
查手册前先确认你用的是真·TP5.1
执行composer show topthink/framework，输出必须是5.1.x（如5.1.41），不是5.0.24也不是5.2.0。TP5.0和TP5.1的where写法、paginate返回结构、Db::name()行为全都不一样——【手册版本错，后面全白看】。
如果显示的是5.0.x，删掉vendor和composer.lock，改composer.json里"topthink/framework": "^5.1"再composer install。
数据查询基本原则：WHERE条件必须写全，不能靠“默认”
TP5.1不自动补is_delete=0，不自动加status=1，也不默认排除软删除数据。你写什么，它就查什么。
比如UserModel::where('id', 100)->find()，只查id=100这一条，哪怕该用户delete_time非空也照返回——【软删除字段不会自动过滤】。
要启用软删除，必须显式调用withTrashed()（查全部）或onlyTrashed()（只查已删），否则delete_time IS NOT NULL的数据永远进不了结果集。
这和TP5.0不同：TP5.0在模型里设protected $softDelete = true后会自动加delete_time IS NULL条件；TP5.1废掉了这个开关，全靠手动控制。
链式操作顺序不能乱，尤其分页和排序
第一步：->order('create_time DESC')必须写在->paginate()之前，否则排序失效——TP5.1的paginate内部会重建查询对象，后写的order会被丢弃。
第二步：->field('id,name,phone')要放在->where()之后、->paginate()之前，否则字段裁剪可能漏掉count统计所需的主键字段，导致分页总数为0。
第三步：->paginate(15)必须是链式调用的最后一个方法，不能再接->hidden(['password'])之类——TP5.1的paginate返回的是Paginator对象，不是Collection，没有hidden方法。
如果要隐藏字段，得在模型里用protected $hidden = ['password']，或者对$result->items()返回的集合单独处理。
关联查询避坑：别信手册里的“自动识别”，自己写表别名
方法一：用join硬写，字段明确、可控性强Db::table('user')->alias('u')->join('order o','u.id=o.user_id')->where('o.status',1)->select()
这句能跑通，因为alias('u')和order o都带了别名，u.id和o.status引用无歧义。
方法二：用模型hasOne/hasMany，但必须在关联方法里指定foreign_keyclass UserModel extends Model { public function order() { return $this->hasMany(OrderModel::class, 'user_id', 'id'); } }
注意第二个参数'user_id'不能省——TP5.1不会自动猜外键名，漏写就查不出关联数据。
方法三：用with预加载，但with(['order'=>function($q){$q->where('status',1);}])里的where只作用于order表，不影响主表user筛选——这是常见误解，以为能当join用，其实不能。
调试真实SQL：别只看手册示例，要看自己生成的语句
在查询后立刻加->getLastSql()，例如：UserModel::where('status',1)->order('id desc')->paginate(10)->getLastSql()，它会返回类似SELECT * FROM `user` WHERE `status` = 1 ORDER BY `id` DESC LIMIT 0,10的字符串。
把这条SQL复制到MySQL客户端直接执行，看结果是否和PHP里一致。如果不一致，说明是PHP端数据类型转换问题（比如传字符串'1'进去，数据库比对的是数字1）；如果一致，问题就在PHP数据处理逻辑里。
这比翻手册快十倍——手册写的都是理想路径，而你的数据里有空格、有NULL、有时间戳格式错，只有真实SQL能暴露这些。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
