laravel访问器函数名必须用camelcase，如first_name对应getfirstnameattribute；需在$appends中声明才出现在toarray()；cast优先于accessor执行。
访问器函数名必须用 camelCase，不能用 snake_case
Laravel 的访问器（accessor）是通过约定命名触发的：字段 first_name 对应的访问器函数名必须是 getFirstNameAttribute，而不是 getFirst_nameAttribute。Laravel 内部用 Str::studly() 处理下划线字段转驼峰，再拼上 Attribute 后缀——所以写错命名就完全不会调用。
常见错误现象：dd($user->first_name) 输出原始数据库值，但你明明写了 getFirst_nameAttribute 并在里面加了 return strtoupper($value)，结果毫无反应。
- 字段是
last_login_at→ 访问器函数名必须是getLastLoginAtAttribute - 字段含数字或缩写（如
api_v2_token）→ 仍按规则转为getApiV2TokenAttribute，不是getApi_v2_tokenAttribute - 如果想对非数据库字段加访问器（比如动态拼接的
full_name），函数名照旧：getFullNameAttribute，但内部不调用$this->attributes['xxx']，而是自己计算
访问器里别直接改 $this->attributes
访问器本质是“读取时计算”，不是“赋值钩子”。在 getXXXAttribute 里给 $this->attributes['xxx'] = ... 赋值，会导致后续再次读取该属性时跳过访问器逻辑（因为属性已存在），结果不一致。
使用场景：你想把 status 数字转成中文标签，并缓存转换结果避免重复计算。
- ✅ 正确做法：只返回值，不碰
$this->attributes—— Laravel 每次读取都走访问器 - ❌ 错误写法：
$this->attributes['status_label'] = $labels[$this->status]; return $this->attributes['status_label'];，下次读$user->status_label就直接从 attributes 取，绕过访问器 - 性能影响：访问器本身无缓存，高频调用建议配合
isset($this->attributes['xxx'])做简单记忆（但注意仅限只读场景）
toArray() 和 jsonSerialize() 默认不包含访问器
模型转数组或 JSON 时，Laravel 默认只输出数据库字段和显式定义的 $appends 属性。哪怕你写了 getAvatarUrlAttribute，$user->toArray() 也不会自动带上 avatar_url。
常见错误现象：API 返回数据缺了头像链接，前端说“接口没给”，但你在 Blade 里 {{ $user->avatar_url }} 显示正常。
- 必须在模型里声明：
protected $appends = ['avatar_url']; - 如果访问器依赖敏感数据（比如
is_admin），别加进$appends，否则序列化时暴露风险 - 兼容性注意：Laravel 9+ 支持在
$appends里用点号嵌套（如'profile.full_name'），但前提是profile是关联关系且已加载，否则会报错Trying to get property 'full_name' of non-object
访问器和强制转型（cast）同时存在时，执行顺序是 cast 先于 accessor
比如字段 score 类型是 integer，你又定义了 getScoreAttribute。Laravel 会先按 cast 把数据库原始字符串转成整数，再把该整数传给访问器的 $value 参数。
这意味着：如果你在访问器里想处理原始字符串（比如去掉空格、补零），已经晚了——cast 已经把它变成 int 或 float。
- 需要原始值？删掉
$casts里的对应项，改用访问器手动转型：return (int) trim($value); - 如果只是格式化展示（如加千分位），没问题：
return number_format($value);，因为$value已是数字类型 - Boolean cast 特别容易踩坑：
'active' => 'boolean'会让$value变成true/false，而非"1"或"0"字符串
$appends 忘加或者函数名多了一个下划线。
