Eloquent 查询需显式调用终结方法才能执行：where() 返回Builder，必须接get()/first()/find()等才触发SQL；find()仅支持主键查询；跨表筛选须用whereHas()；all()不可链式调用且无条件。
直接说结论：Eloquent 查询不是“写完就出结果”，关键在搞清 where、get、first、find 这几个方法的返回类型和执行时机——错一步，查不到数据、报错、或性能崩掉。
where() 后不加 get()/first() 就只是个 Builder 对象
很多人写 User::where('status', 1) 就停了，以为已经查出数据。其实它返回的是 Illuminate\Database\Eloquent\Builder 实例，SQL 根本没发出去。
- 必须接
->get()才真正执行查询，返回Illuminate\Database\Eloquent\Collection - 接
->first()或->find(123)也执行查询，但只取一条，返回单个模型实例（或null） - 漏掉终止方法，后续调用
toArray()或遍历会报错：“Call to a member function toArray() on null” 或 “Trying to iterate over Builder”
find() 只认主键，且不能链式加 where
find() 是快捷入口，但限制明确：它底层走的是主键等值查询，不支持字段名、不支持复合条件。
-
User::find(5)→ 等价于SELECT * FROM users WHERE id = 5，安全、高效 -
User::find([1,2,3])→ 查多个主键，返回集合；但传字符串或带条件的链式调用（如->where(...)->find(5)）会静默失败或返回空 - 想按邮箱查用户？别硬套
find()，改用User::where('email', 'x@y.z')->first()
whereHas() 是跨表筛选主模型的唯一可靠方式
要查“有活跃订单的用户”，不能写 User::with('orders')->where('orders.status', 'paid')——这会报错，因为 orders 不在 users 表里。
- 正确姿势是
User::whereHas('orders', function ($q) { $q->where('status', 'paid'); })->get() -
whereHas()生成 EXISTS 子查询（或 JOIN），确保只返回满足关联条件的主模型 - 如果还要把订单数据一起带上，再加
->with('orders')，避免 N+1；但注意：两个方法顺序可换，效果一样，with()不影响whereHas()的筛选逻辑
all() 和 get() 看似一样，但触发时机和语义不同
all() 是静态方法，隐式调用 get()，但它不接受任何查询条件——一旦加了 where，就必须用 get()。
-
User::all()→ 安全，查全表；但数据量大时慎用，无分页、无条件、不可链式扩展 -
User::where('active', 1)->get()→ 显式、可控，推荐日常使用 -
User::where('active', 1)->all()→ 报错：Method all does not exist，因为all()只挂在模型类上，不在 Builder 实例上
最容易被忽略的点：所有 Eloquent 查询方法都返回“惰性对象”，只有遇到 get、first、count、exists 这类终结方法才会真正执行 SQL。写完 where 忘记收尾，调试时 dump 出来是个 Builder，不是数据——这不是 bug，是设计使然。
