在 Laravel 中，Model::query() 与 Model::where() 功能等价，核心差异仅在于 IDE 类型提示更准确、链式调用起点更明确；二者底层均通过 newQuery() 初始化查询构建器，性能无实质差别。
在 laravel 中，`model::query()` 与 `model::where()` 功能等价，核心差异仅在于 ide 类型提示更准确、链式调用起点更明确；二者底层均通过 `newquery()` 初始化查询构建器，性能无实质差别。
Laravel 的 Eloquent 模型提供了多种启动查询的方式，最常见的是直接调用静态作用域方法（如 User::where('active', true)->get()）或显式调用 User::query()->where(...)->get()。表面上看两者结果一致，但其内部机制与开发体验存在关键区别。
底层原理：殊途同归
- User::where(...) 是一个魔法静态方法调用：Eloquent 首先触发 __callStatic()，实例化模型后转交至实例的 __call()，最终通过 forwardCallTo($this->newQuery(), $method, $parameters) 将请求委托给全新的查询构建器（QueryBuilder）实例。
- User::query() 则是显式构造查询构建器：它直接调用静态方法 query()，该方法返回 (new static)->newQuery()，即一个已初始化的 Illuminate\Database\Eloquent\Builder 实例。
二者最终都指向同一个 Builder 实例，因此生成的 SQL、执行逻辑、性能表现完全一致——没有任何运行时开销差异。
真正优势：开发体验与可维护性
虽然功能等价，但 ::query() 具有明确的语义和工程价值：
✅ IDE 支持更精准
现代 IDE（如 PHPStorm、VS Code + Intelephense）能准确识别 User::query() 返回类型为 Builder，从而提供完整的链式方法提示（如 select(), withTrashed(), forUpdate() 等），而 User::where() 在部分复杂上下文中可能因动态代理丢失类型推断。
✅ 意图更清晰，利于重构
// 推荐：意图明确，便于后续扩展（如添加 with()、scopes 或条件分支）
$users = User::query()
->where('status', 'active')
->when($isAdmin, fn ($q) => $q->withTrashed())
->orderBy('created_at')
->get();
// 可读性稍弱，且难以在 where 前插入其他查询修饰
$users = User::where('status', 'active')->get();✅ 统一入口，避免歧义
当模型定义了同名静态方法（如 User::where() 被手动重写）时，::query() 可绕过自定义逻辑，确保获取原始查询构建器，提升可预测性。
使用建议
- ✅ 日常开发推荐 Model::query()：尤其在复杂查询、条件组合、测试构造器或需要强类型提示的场景；
- ✅ 简单单条件查询可沿用 Model::where()：语法更简洁，团队约定优先；
- ⚠️ 避免混用风格：项目中应统一规范（如 Code Review 规则要求所有查询以 ::query() 开始），提升代码一致性；
- ? 无需为性能担忧：两者差异仅为一次方法转发调用（纳秒级），对应用性能无任何影响。
总之，::query() 不是“必须”，而是“更专业”——它让代码更可读、更可维护、更易被工具理解，是 Laravel 高质量实践的微小却重要的体现。
