访问器仅在读取模型属性时触发，需严格遵循get{Attribute}Attribute命名规范，从$this->attributes取原始值以防递归，并配合$appends控制序列化输出。
访问器不是“定义完就能自动生效”的魔法，它只在模型属性被读取时触发，且必须遵循命名规范、配合 $casts 或原始字段名使用，否则根本不会运行。
访问器函数名必须是 get{Attribute}Attribute 格式
比如想处理数据库里的 price 字段，显示带 ¥ 符号的格式，访问器函数名得是 getPriceAttribute，不能写成 formatPrice 或 priceAccessor。Laravel 通过方法名反射自动识别，拼错一个字母就失效。
- 数据库字段叫
user_name→ 访问器必须叫getUserNameAttribute（首字母大写，下划线转驼峰） - 字段叫
is_active→ 对应getIsActiveAttribute，不是getIsactiveAttribute - 如果字段本身是驼峰（如
firstName），访问器就是getFirstNameAttribute，不额外转换
访问器里用 $this->attributes['xxx'] 读原始值
在 getXXXAttribute 方法内部，不能直接写 $this->xxx，否则会无限递归调用自己。原始字段值要从 $this->attributes 数组里取。
public function getPriceAttribute()
{
// ✅ 正确：从 attributes 取原始值
$raw = $this->attributes['price'];
return '¥' . number_format($raw, 2);
// ❌ 错误：$this->price 会再次触发 getPriceAttribute()
// return '¥' . number_format($this->price, 2);
}
访问器不改变数据库存储，也不影响 toArray() 和 JSON 输出
访问器只影响模型实例上属性的读取行为，对查询、保存、序列化默认无副作用。想让 toArray() 或 API 返回也包含加工后的值，得手动加到 $appends 数组里。
- 没加
$appends：调用$model->price是带 ¥ 的，但$model->toArray()里还是原始数字 - 加了
protected $appends = ['price'];：JSON 响应里也会出现"price": "¥199.00" - 注意：如果字段本身是
int类型，又加了$appends，返回字符串可能破坏前端类型预期
和 $casts 配合时要注意执行顺序
访问器在 $casts 转换之后运行。比如 price 设为 'price' => 'integer'，那 $this->attributes['price'] 在访问器里拿到的就是整数，不是字符串或 float —— 这点容易被忽略，导致 number_format 出现精度问题。
- 如果数据库存的是
DECIMAL(10,2)，建议 cast 为'price' => 'decimal:2'（需 Laravel 9+）或保持 string，再在访问器里处理 - 不要在访问器里重复做类型转换，比如 cast 已转成 int，你还用
(float)强转，反而引入浮点误差 - 批量赋值（
create()/fill()）不触发访问器，只影响读取侧
真正容易出问题的地方，是以为访问器能“接管所有读操作”——它不介入查询构建、不修改原始数据、不参与验证，只是一个属性读取时的轻量钩子。用错场景，比如试图用它过滤关联数据或做权限判断，很快就会掉进逻辑分散的坑里。
