ThinkPHP模型追加虚拟字段必须同时满足：$append声明字段名、存在严格匹配的public getXXXAttr()方法、方法名大小写及Attr后缀正确，缺一不可；否则报Call to undefined method或字段不显示。
ThinkPHP模型里追加虚拟字段，核心就一条：必须同时满足「$append声明 + getXXXAttr方法存在 + 方法名严格匹配」，缺一不可，否则500或字段消失。
为什么append字段不显示、或者直接报Call to undefined method？
最常见原因是字段名和获取器方法名没对上，或者方法根本没定义。TP不会帮你容错，而是直接抛出致命错误。
-
$append里写的是'status_text'，对应方法必须叫getStatusTextAttr()，不能是getStatustextAttr()或statusTextAttr() - 方法必须是
public，且至少接受一个参数（$value），第二个参数$data可选但强烈建议带上，用来安全读取原始数据 - 如果模型启用了
protected $strict = true，而字段又不在数据库表中，$this->xxx会返回 null；但获取器仍会执行——所以别在获取器里写$this->nonexistent_field，改用$this->data['nonexistent_field'] ?? '' - 查日志看到
Call to undefined method ... getStatusTextAttr()？立刻检查拼写、大小写、是否漏了Attr后缀
select() 返回的集合里 append 字段为啥不生效？
因为 select() 默认返回的是 Collection 对象，它不自动触发每个模型实例的 $append；只有单个模型（如 find()）或显式调用 toArray() 才会走完整序列化流程。
- 正确做法：
$list = User::select(); $list->toArray();—— 这会遍历每条记录并应用$append和所有获取器 - 如果模型已设置
protected $resultSetType = 'collection'，那User::all()返回的就是可链式调用的 Collection，可直接->toArray() - 错误写法：
User::append(['xxx'])->select()——append()是实例方法，不能在静态查询链上直接调用；得先拿到模型实例再追加 - 想在查询时就预加载关联并支持关联字段追加？用
with('profile')+appendRelationAttr('profile', ['nickname'])
append() 实例方法 vs $append 静态属性，什么时候该用哪个？
两者行为完全不同：静态 $append 是全局默认开关，实例 append() 是单次覆盖操作。混用容易丢字段或重复执行获取器。
立即学习“PHP免费学习笔记（深入）”；
- 静态
protected $append = ['full_name', 'is_active']：适合所有接口都需一致输出的字段，一旦定义，所有toArray()、json()都自动包含 - 实例
$user->append(['score_rank'])：适合仅某次查询需要额外字段，比如详情页比列表页多一个统计值 - 注意：
append(['a'])不是“追加”，而是“清空原有 + 只留 a”；想叠加，得手动合并：$user->append(array_merge($user->getAppend(), ['new_field'])) - 性能敏感场景慎用：100 条记录 + 5 个
$append字段 = 500 次获取器调用；若获取器里有 DB 查询，QPS 会断崖下跌
虚拟字段依赖关联数据时怎么避免 N+1 或空值？
获取器里直接访问未预加载的关联（如 $this->profile->nickname）会导致 null 或懒加载失败，进而让整个字段为空。这不是 append 的问题，是数据加载时机没对齐。
- 优先在查询时显式
with('profile')，再在获取器里用$this->profile->nickname ?? '' - 不想强制 with？改用
$this->getData('profile')安全读取，它返回关联对象或 null，不会触发懒加载异常 - 更稳妥的做法：在获取器里只读
$this->data，把计算逻辑前置到查询构造阶段，比如用field('*, CONCAT(first_name, " ", last_name) AS full_name')让数据库拼好再映射 - 别在获取器里做远程请求、文件读取、复杂循环——这些操作在批量输出时会被放大 N 倍
真正难的不是怎么写 append，而是判断哪些字段该由模型计算、哪些该由数据库算、哪些该由前端拼。TP 的 append 机制很轻量，但一旦滥用，排查起来全是隐性调用链。
