thinkphp 8 中 scope 方法必须为 public static，仅修改 $query 并返回，不可执行查询或返回数据；参数签名须严格匹配；多 scope 组合时 sql 子句顺序影响结果；与全局作用域同字段条件会导致逻辑冲突。
ThinkPHP 8 中的 scope 方法已完全移除 _scope 静态数组机制，也不再支持非 public static 定义或返回数据的写法——任何偏离“接收 $query、只拼条件、不执行查询、必须返回 $query”的行为都会静默失效。
scope 方法必须声明为 public static
TP8 强制要求所有 scope 方法为 public static，否则调用时不会被识别。这不是可选项，是框架底层反射匹配的硬性规则。
- 错误写法：
public function scopeHot($query)→ 方法存在但被忽略，无报错无日志 - 正确写法：
public static function scopeHot($query)→ 框架能正确注入并链式传递 - 若模型继承自基类（如
BaseModel），基类中定义的public staticscope 会被子类自动继承，无需重复声明
scope 内不能调用 select()、find() 或 return 数组
scope 的唯一职责是修改 $query 对象的状态，不是执行查询。一旦在 scope 里调用了 select()，链式就会中断，后续的 ->where() 或 ->order() 全部失效。
- 错误写法：
return $query->where('status', 1)->select();→ 返回的是结果集，不是$query - 正确写法：
$query->where('status', 1); return $query;→ 必须返回$query，且不执行任何查询方法 - 常见误操作：在 scope 中写
self::where(...)->find()，这会脱离当前查询上下文，条件不生效
带参 scope 的签名与调用必须严格对应
TP8 对参数传递不做容错转换，传参方式和方法形参数量/默认值必须完全一致，否则参数为 null 或触发 PHP Warning，但查询仍会执行（只是条件没按预期加）。
- 定义为
public static function scopeHot($query, $min = 1000)，才能接受->scope('hot', 5000) - 若想支持关联数组传参（如
->scope(['hot' => 5000])），方法必须写成public static function scopeHot($query, $params = [])，再从$params['hot']取值 - 调用
->scope('hot')但方法定义了第二个参数且无默认值 →$min为null，where('views', '>=', null)会导致 SQL 错误或全表扫描
多个 scope 组合时 limit/order 等子句顺序决定最终行为
TP8 不重排 SQL 子句顺序，scope 是线性拼接的。如果一个 scope 包含 limit(10)，另一个包含 order('created_at', 'desc')，谁先调用，谁的子句就出现在 SQL 前面——而 MySQL 要求 ORDER BY 必须在 LIMIT 之前才有效，否则可能被忽略或报错。
-
User::scope('top')->scope('latest')->select()→ 先LIMIT 10再ORDER BY，结果不可控 -
User::scope('latest')->scope('top')->select()→ 先排序再取前 10 条，符合预期 - 调试建议：用
buildSql()查看生成的 SQL，确认ORDER BY是否在LIMIT前
最易被忽略的一点：scope 不会覆盖全局作用域（如软删除的 delete_time IS NULL），但如果 scope 里又加了同字段的 where 条件（比如 status = 2），而全局作用域已是 status = 1，最终 SQL 就是 WHERE status = 1 AND status = 2，永远查不到数据——这种冲突不会报错，只会返回空结果集。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
