TP8中scope方法必须为public static，仅拼接条件且操作$query对象；非法调用、错误签名或执行select()会导致静默失效。
ThinkPHP 8 中的 scope 方法没有“升级限制”——它根本没变，也没新增限制。TP8 沿用 TP5.1+ 的 scope 机制，和 TP6/TP7 完全一致。所谓“限制”，其实是开发者误用旧版 _scope 数组、混淆调用方式或忽略签名规则导致的静默失效。
scope 方法必须声明为 public static
TP8 不再接受非静态的 scope 方法。如果写成 public function scopeHot($query)（缺 static），调用时不会报错，但条件根本不会拼进去，buildSql() 也看不到对应 WHERE 子句。
- 正确写法：
public static function scopeHot($query, $min = 1000) { $query->where('views', '>=', $min); } - 错误写法：
public function scopeHot($query)（无static）、protected static function scopeHot(...)（权限不足） - TP8 会跳过所有非
public static的 scope 方法，不警告也不提示
scope 调用必须走模型门面或实例，不能直接调方法名
你不能写 User::scopeHot() 或 (new User())->scopeHot() —— 这是普通方法调用，TP8 完全不识别。scope 只在查询链中通过 ->scope() 触发。
- 合法调用：
User::scope('hot', 5000)->select()、User::where('id', 1)->scope('hot')->find() - 非法调用：
User::scopeHot(5000)（返回 void，无链式）、User::scope(['hot' => 5000])（需方法签名支持$params，否则参数被丢弃） - 注意：TP8 不支持
->scope('hot', ['min' => 5000])这种嵌套数组传参；只认单值或键值对数组（如['hot' => 5000]），且方法必须显式接收$params
scope 内禁止执行 select() / find() / paginate()
TP8 的 scope 仍是纯条件拼接器，不是执行器。一旦在 scope 方法里调了 $query->select()，链式就中断，后续调用（比如再加 ->order()）会被忽略，而且可能触发 PHP Warning：“Cannot modify header information”（因提前输出）。
立即学习“PHP免费学习笔记（深入）”；
- 正确做法：只调
$query->where()、$query->order()、$query->limit()等构建器方法 - 错误示例：
return $query->where(...)->select();（返回的是结果集，不是$query对象） - 调试技巧：用
User::scope('hot')->buildSql()查看生成的 SQL，确认 WHERE 是否出现，比盲猜快得多
scope 和全局作用域（globalScope）叠加时条件冲突很隐蔽
TP8 全局作用域（如软删除）默认包裹所有查询，scope 条件在其内部。如果你的全局作用域写了 delete_time IS NULL，而某个 scope 又写了 status = 2，那没问题；但如果 scope 错误地重写了已被全局作用域锁定的字段（比如 status = 1），就会变成 WHERE (status = 1) AND (status = 1) —— 表面正常，实则冗余甚至掩盖逻辑错误。
- 典型陷阱：
scopePublished($query)里写$query->where('status', 1)，但全局作用域已含status IN (1,2)，此时 scope 实际缩小了范围，但你可能以为它只是“标记” - 安全做法：scope 只加“增量条件”，避免覆盖全局作用域已声明的业务状态字段
- 真正需要覆盖时，改用闭包 +
use显式控制，而不是依赖 scope 隐式叠加
