get{attributename}attribute 是定义访问器的唯一有效方式，必须严格遵循驼峰命名规则，如 first_name 对应 getfirstnameattribute；参数 $value 为数据库原始值；需在 $appends 中声明才能序列化输出；同名字段会被屏蔽，getidattribute 会破坏框架功能。
get{AttributeName}Attribute 方法是定义访问器的唯一有效方式，不写对命名就完全不会触发。
访问器方法名必须严格遵循驼峰规则
数据库字段叫 first_name，对应访问器必须是 getFirstNameAttribute；字段叫 created_at，就得写 getCreatedAtAttribute。Laravel 不做任何模糊匹配或下划线转驼峰的自动修正——写成 getFirst_nameAttribute 或 getfirstnameAttribute 都无效。
常见错误现象：$user->first_name 仍返回原始值，控制台无报错，容易误以为逻辑没生效。
- 字段名含多个下划线（如
is_active_flag）→ 访问器应为getIsActiveFlagAttribute - 字段本身已是驼峰（如
fullName）→ 访问器就是getFullNameAttribute，不额外转换 - 别试图用
getAttribute或重写__get—— 这会绕过 Eloquent 的访问器机制
访问器参数 $value 是数据库原始值，不是模型属性
访问器方法签名里带的 $value 参数，是该字段从数据库查出来的原始值（比如 created_at 是字符串 "2025-12-01 10:30:45"），不是 $this->created_at 的结果。这意味着：
- 你不能在
getCreatedAtAttribute($value)里再写$this->created_at，否则会递归调用自己，直接报Maximum function nesting level - 如果想基于其他字段计算（如拼接
first_name和last_name），就直接读$this->first_name和$this->last_name，它们各自可能也有自己的访问器，Laravel 会自动处理链式调用 - 修改器同理：
setEmailAttribute($value)中的$value是你赋的值（如"JOHN@EXAMPLE.COM"），不是$this->email
需要 JSON/API 返回时记得加到 $appends
访问器定义后，$user->display_name 在 PHP 里能取到，但 $user->toArray() 或 API 响应中默认不包含它。要让它自动出现在序列化结果里，必须显式声明：
protected $appends = ['display_name'];
注意：$appends 里的名字是属性名（display_name），不是方法名（getDisplayNameAttribute）。漏写这行，前端永远收不到这个字段。
- 如果访问器依赖敏感数据（如手机号脱敏），别盲目加进
$appends，得配合隐藏字段（$hidden）或条件追加 -
$appends只影响toArray()、toJson()和 API Resource，不影响pluck()或select()查询结果 - 多个访问器要全部列出来：
['display_name', 'full_address', 'status_label']
访问器和同名字段不能共存
如果你定义了 getNameAttribute，又在数据库里有 name 字段，那每次读 $user->name 都走访问器——原始值被彻底屏蔽。这本身不是 bug，但容易引发意外：
- 想临时读原始值？用
$user->getOriginal('name') - 想在访问器里用原始值做判断？参数
$value就是它，别去读$this->name - 千万别定义
getIdAttribute—— 会破坏 Eloquent 内部 ID 解析，导致关联、更新全失效
最常被忽略的一点：访问器只在通过模型实例读取属性时生效。用 DB::table('users')->select('name')->get() 或原生 SQL 查出来的数据，完全不经过任何访问器。别指望它对所有查询路径都起作用。
