应通过访问器（getFullNameAttribute）配合$appends添加逻辑字段，或在API资源层映射别名；修改getColumnListing会导致迁移失败、IDE助手异常等严重问题。
getColumnListing 返回的字段名不经过模型访问器，怎么统一加别名？
直接改 getColumnListing 不解决问题——它只在 Schema 构建、迁移、DB::getSchemaBuilder()->getColumnListing() 这类元数据场景里调用，和 Eloquent 查询结果完全无关。你查出来的 $user->name 是从查询结果数组映射到模型属性的过程，跟这张表“物理有哪些列”是两回事。
真正起作用的是模型的 $casts、$appends、访问器（accessor），以及查询时手动 selectRaw 或 addSelect。别名映射不是靠改元数据函数，而是控制「查询时返回什么键」和「模型暴露什么属性」。
想让 $user->full_name 返回 SELECT 中的 `CONCAT(first_name, ' ', last_name)` 怎么做？
这是最常见需求：数据库没这个字段，但业务要一个逻辑字段，并希望像原生属性一样用。不能靠 getColumnListing，得靠访问器 + $appends。
- 在模型里定义访问器：
getFullNameAttribute()，里面写拼接逻辑 - 把
full_name加进$appends = ['full_name'] - 如果该字段需被
toArray()/ API 返回，且不想每次手动调->getAttributes()，这一步必不可少 - 注意：访问器不会自动参与
where查询，where('full_name', '...')会报错——它不是真实列
SELECT 语句里想统一给字段起别名（比如所有下划线转驼峰），该在哪层下手？
必须在查询构造阶段干预，Eloquent 没提供“全局字段别名钩子”。可行路径只有两个：
- 用
selectRaw显式写出带别名的字段：User::selectRaw('id as userId, name as userName')—— 简单直接，但无法复用 - 封装一个查询构建器扩展方法，比如
withCamelCaseSelect()，内部遍历Schema::getColumnListing()结果，用Str::camel()转换后拼selectRaw—— 注意：仅适用于全量查，且不兼容withCount、withSum等聚合字段 - 更稳妥的做法是接受数据库列名不变，在 API 层（如 Resource 类）做字段映射：
'user_id' => $this->id，解耦更干净
重写 getColumnListing 会导致哪些意外问题？
有人试图在自定义 Schema Grammar 或通过 DB facade 替换连接器来劫持 getColumnListing，结果发现：
- Migration 回滚失败：Laravel 内部依赖原始列名判断字段是否存在、类型是否变更
-
php artisan migrate:fresh --seed报SQLSTATE[42S22]: Column not found，因为迁移系统读到的是别名列，但建表语句里还是原始名 - 第三方包（如 laravel-ide-helper）生成模型注释出错，因为它靠
getColumnListing反推属性，别名一塞进去就全乱 - 哪怕只在开发环境改，也容易误提交，污染团队协作流程
字段别名是表现层的事，硬塞进元数据层，等于把 UI 逻辑打进数据库驱动里——改起来痛，查起来更痛。
