Eloquent 中不能用 AS 做字段别名映射，因 select() 会剥离别名且不绑定到模型属性；DB::table()->selectRaw() 可生效但返回数组而非模型实例；需根据是否依赖模型功能选择原生查询或访问器+appends 方案。
不能直接用 AS 关键字在 Eloquent 查询中做字段别名映射 —— 它会被 Laravel 自动忽略或引发 SQL 错误。
为什么 SELECT id AS user_id 在 DB::table() 里能用，但在 Model::select() 里失效
Eloquent 的 select() 方法默认把字段名当模型属性绑定，而 AS 别名不会自动映射到模型实例的属性上；更关键的是，Laravel 的 Query Builder 会剥离 AS 后的别名，只保留原始字段名参与后续处理（比如自动补全 created_at 类型转换、隐藏字段过滤等）。
常见错误现象：Model::select('id AS user_id')->first()->user_id 报错或返回 null；或者查出来字段名仍是 id，没变成 user_id。
Laravel Cloud
下载
Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。
- 使用场景：需要对接前端字段规范（如统一用
user_id而非id），或合并多表查询时避免字段名冲突 - 参数差异：
DB::table('users')->selectRaw('id AS user_id')可以生效，但返回的是原生数组，不是模型实例 - 性能影响：无额外开销，但若强行用
selectRaw+ 模型构造，会绕过 Eloquent 的属性填充逻辑，丢失访问器（getXXXAttribute）、强制类型转换等能力
用 selectRaw() + toArray() 替代模型实例，是最稳的别名方案
如果你只需要数据，不依赖模型方法、事件、关系加载，那就别硬套模型。用原生查询走通路，清晰且可控。
- 实操建议：用
DB::table('users')->selectRaw('id AS user_id, name AS full_name')->where('active', 1)->get()->toArray() - 注意
selectRaw()不会帮你转义字段名，如果字段含空格或关键字，得手动加反引号：selectRaw('`order` AS order_number') - 兼容性：所有 Laravel 版本都支持，不受模型配置（如
$casts、$appends）干扰 - 别踩坑：不要混用
selectRaw()和with()—— 关系预加载会失效，因为底层已脱离模型上下文
想保留模型实例？用 asArray() 或手动映射属性
没有内置“字段别名 → 属性名”的映射机制，但可以通过后期处理让模型“看起来”有别名字段。
- 方案一（推荐）：在模型里加访问器，例如
getUserIdAttribute()返回$this->id，然后toArray()时通过$appends加进去 - 方案二：查完后用
map()手动重键：Model::all()->map(fn($m) => ['user_id' => $m->id, 'full_name' => $m->name]) - 性能提醒：方案二在大数据集下会明显变慢；方案一要小心循环引用（比如
getUserIdAttribute又调了userId） - 别漏掉：如果用了
hidden或visible，新字段名必须显式列进去，否则toArray()不会出现
真正麻烦的不是怎么写别名，而是别名之后要不要走模型生命周期 —— 要，就得绕着规则填缝；不要，就干脆别用模型。很多人卡在这一步，反复试 AS 却不看返回值类型，最后发现查出来是 stdClass 或数组，根本不是 Model 实例。
