Laravel 中 Traits 依赖 PHP 原生机制，需 use 显式引入、手动配置 PSR-4、处理冲突（insteadof/as）、注意可见性与属性覆盖；不自动加载，无 artisan 命令，适用多类复用非核心行为。
Traits 在 Laravel 中怎么被加载和自动发现
Laravel 本身不干预 PHP 的 Traits 加载机制——它完全依赖 PHP 原生规则：Traits 必须在类定义前通过 use 显式引入，不会自动扫描、不会按命名约定加载，也不进 Composer autoloader。
- Laravel 的服务容器、模型、控制器这些类里用 Traits，和纯 PHP 项目写法完全一致
- 没有类似
php artisan make:trait这种命令，官方不提供生成器 - 如果把 Trait 放在
app/Traits/下，得自己在composer.json里加 PSR-4 映射，否则use App\Traits\SomeTrait;会报错 Class not found - 常见错误：
PHP Fatal error: Trait 'App\Traits\Logger' not found，大概率是命名空间没对上，或composer dump-autoload没跑
什么时候该用 Trait 而不是继承或 Service 类
核心判断标准：是否在「多个不相关类中复用同一组行为」，且这些行为不属于领域核心职责。
-
✅ 合适场景：
- 多个 Eloquent 模型都要记录创建/更新时间（
HasTimestamps已内置，但自定义如LogsActivity） - 多个 API 控制器都需要统一的权限校验逻辑（
AuthorizesRequests是现成例子） - 多个命令类都要发 Slack 通知，且逻辑简单（不值得单独抽 Service）
- 多个 Eloquent 模型都要记录创建/更新时间（
-
❌ 别硬套场景：
- 业务逻辑强耦合（比如「订单支付流程」在 Order 和 Refund 里都用，该抽 Service 类，不是 Trait）
- 需要构造函数注入依赖（Trait 不能有构造函数，
__construct()写进去也不会被调用） - 想覆盖父类方法却忘了用
insteadof处理冲突，结果运行时静默失败
Trait 冲突和方法重写必须手动处理
PHP 不会帮你决定哪个同名方法该生效。只要两个 Trait 或 Trait 与当前类定义了同名方法，就必须显式声明。
- 冲突现象：
PHP Fatal error: Trait method handle has not been applied, because there are collisions with other trait methods - 解决方式只有两种：
- 用
insteadof排除某个实现：use Notifiable, Dispatchable { Dispatchable::handle insteadof Notifiable; } - 用
as重命名方法：use Notifiable, Dispatchable { Dispatchable::handle as dispatchHandle; Notifiable::handle as notifyHandle; }
- 用
- 容易漏掉的点：Laravel 自带 Trait（如
InteractsWithQueue）也可能和你自己写的同名方法撞车，别只盯着自己写的 Trait
在 Eloquent 模型里用 Trait 要小心访问控制和属性可见性
Trait 里的属性和方法，会直接“平铺”进使用它的类，但 visibility 规则照常生效。
-
protected属性在 Trait 里声明，进了模型后仍是protected，不能被外部直接读写 -
public function scopeActive()这种作用域方法，放进 Trait 后，在模型上调用MyModel::active()是 OK 的；但若写成private function scopeActive()，就会失效（Eloquent 不识别 private 作用域） - 常见坑：在 Trait 里用了
$this->fillable，结果模型没设protected $fillable = []，运行时报MassAssignmentException—— 因为 Trait 并不自动合并数组，它只是复制代码，$fillable被完全覆盖而非追加
Laravel 的 Trait 是语法糖，不是魔法。它不改变类的继承链，不参与 DI，也不自带生命周期钩子。写的时候多看一眼 PHP 手册里 Traits 章节，比查 Laravel 文档更管用。
