trait必须use进模型类内部才能生效，不可在控制器或配置中注册；方法名冲突时类方法优先覆盖trait方法，需用insteadof/as显式处理；scope方法必须声明$query参数并返回$query，否则查询失效。
ThinkPHP 中的 trait 不是用来“配置启用”的，而是直接 use 进类里就能生效——但必须注意方法冲突、作用域和调用时机，否则看似复用了，实则被覆盖或静默失效。
trait 必须写在模型类内部，不能放配置或控制器里
ThinkPHP 的模型是复用逻辑最密集的地方，比如软删除、数据脱敏、状态转换等。这些通用行为适合抽成 trait，但只能在模型类中 use，不能在控制器、中间件或全局配置里“注册”或“自动加载”。
-
use语句必须写在class定义内，且在class关键字之后、{之前 - 不能在
__construct()或任意方法里动态use—— PHP 语法不支持 - 如果 trait 方法名和模型已有方法重名，模型方法会无条件覆盖 trait 方法（优先级：类方法 > trait 方法 > 父类方法）
- 想强制用 trait 的版本？得显式写
parent::methodName()或改名：use MyTrait { myMethod as traitMyMethod; }
scope 和 trait 混用时，$query 参数容易传丢
很多开发者把 scope 方法也塞进 trait，结果调用 ->scope('hot') 报错或条件没生效。根本原因是：scope 方法签名必须接收 $query 第一个参数，而 trait 里的方法若没显式声明参数，PHP 不会自动注入查询对象。
- 错误写法：
public function scopeHot() { ... }→ 缺少$query形参，TP 调用时不会传入查询实例 - 正确写法：
public function scopeHot($query, $days = 7) { $query->where(...); return $query; } - trait 内部不能直接调用
$this->where()替代$query->where()，因为$this是模型实例，不是当前链式查询对象 - 返回
$query是硬性要求，漏写会导致后续select()报错或查出全表
多个 trait 共存时，同名方法必须手动解决冲突
比如你同时 use SoftDelete 和 use DataMask，两个 trait 都定义了 delete() 方法，ThinkPHP 不会帮你选，PHP 直接报致命错误 PHP Fatal error: Trait method delete has not been applied。
- 用
insteadof明确排除某个版本：use SoftDelete, DataMask { delete as maskDelete; } - 用
as重命名保留两者：use SoftDelete { delete as softDelete; } use DataMask { delete as maskDelete; } - 别依赖“后
use的覆盖前一个”，PHP 不按顺序决定优先级，只按是否显式声明冲突处理 - 如果 trait 方法只是辅助逻辑（如
formatPhone()），建议加前缀避免冲突，比如maskFormatPhone()、logBeforeDelete()
trait 里不能访问 $this->table 或 $this->name 动态属性
ThinkPHP 模型的 $table、$name 是实例属性，而 trait 方法在编译期就被混入，运行时若在 trait 中直接读 $this->table，可能拿到空值或父类默认值——尤其当模型继承自基类且未显式赋值时。
- 安全做法：在 trait 方法里通过
static::getTable()获取（TP6+ 支持），或传入模型实例：public function doSomething($model) { $table = $model->getTable(); } - 避免在 trait 构造逻辑里写
$this->field()或$this->where()，这些是模型实例方法，不是查询构建器方法 - 想统一设置字段规则？改用
protected $schema配合 trait 初始化，而不是在 trait 里硬编码$this->field = [...]
真正难的不是写 trait，而是判断哪段逻辑该进 trait、哪段该进基类模型、哪段该进 service 层——比如分页参数处理适合 trait，但订单状态机流转更适合独立 service 类。别为了复用而复用，模型里堆满 trait 反而让职责更模糊。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
