ThinkPHP模型中安全追加虚拟字段需在$append数组中声明字段名并定义对应getXXXAttr()获取器，避免未定义方法报错；优先预加载关联数据防N+1；注意5.1与6.x签名差异及hidden/visible优先级高于append。
ThinkPHP 模型里怎么安全追加多个虚拟字段
直接在模型的 append 属性里写字段名数组，但必须确保这些字段对应的方法已定义且返回值明确。不加校验地追加未定义方法，运行时会报 Call to undefined method 错误。
常见错误现象：接口返回数据突然少字段、或直接 500；查日志发现是模型试图调用一个不存在的 getXXXAttr 方法。
-
append里的每个字段名，都必须有对应命名的获取器方法，比如'status_text'就得有getStatusTextAttr() - 方法体内别做耗时操作（如查库、远程请求），否则批量查多条记录时性能断崖式下跌
- 如果字段值依赖其他字段计算，优先用
$this->data['xxx']读取原始值，而不是再调$this->xxx，避免触发重复获取器
protected $append = ['status_text', 'is_active', 'full_name'];
ThinkPHP 6 的 append() 方法和静态属性的区别
两者都能追加字段，但行为差异极大：静态 $append 是“全局默认”，而 append() 实例方法是“单次覆盖”。混用容易漏掉字段或重复执行获取器。
使用场景：列表页需要全量虚拟字段，详情页只加其中一两个——这时该用实例方法；所有地方都要一致输出，才配静态属性。
立即学习“PHP免费学习笔记（深入）”；
- 静态
$append在模型初始化时就注册，后续所有toArray()、json()都生效 -
$model->append(['xxx'])会清空之前所有追加项，只保留这次传入的，不是叠加 - 想叠加？得手动合并：
$model->append(array_merge($model->getAppend(), ['new_field']))
虚拟字段里要读关联模型数据，怎么避免 N+1
直接在 getXXXAttr() 里调 $this->relation->field，看似简洁，实则每条记录都触发一次关联查询。100 条记录就是 100 次 SQL。
正确做法是提前预加载，在查询时就用 with() 把关联数据抓下来，虚拟字段里只做取值映射。
- 错误写法：
return $this->hasOneRel->name ?? '';（每次调都查库） - 正确写法：
return $this->hasOneRel ? $this->hasOneRel->name : '';，前提是查询时已with('hasOneRel') - 没预加载又必须读关联？至少缓存一下：
$this->hasOneRel ?? $this->setRelation('hasOneRel', $this->hasOneRel()->find($this->rel_id))
ThinkPHP 5.1 和 6.x 在虚拟字段上的兼容性坑
5.1 的 getAttr() 获取器签名是 function($value, $data)，6.x 改成 function($value, $data, $model)。升级后不改方法签名，字段值会变成 null 或错乱。
另一个坑：6.x 默认开启严格模式，append 字段若在 hidden 或 visible 里被排除，照样不会输出——这点很多人忽略。
- 检查方法参数个数，6.x 多了一个
$model参数，不加会导致逻辑跳过 -
hidden和visible的优先级高于append，字段进了hidden列表，追加也没用 - 5.1 允许在
append里写不存在的字段（静默忽略），6.x 会直接抛异常，必须一一对应
复杂点在于：虚拟字段的生命周期横跨模型实例化、数据赋值、序列化三个阶段，任一环节的配置冲突或方法缺失，都会导致字段消失或报错，而且不容易定位到源头。
