ThinkPHP模型追加字段必须同时满足三个条件：字段名在$append中声明、存在命名正确的public无参获取器方法、模型中声明该字段为可读属性（如protected $full_name;），缺一不可。
ThinkPHP 模型追加字段不是“加个配置就完事”，而是必须同时满足三个条件：字段名在 $append 里声明、对应获取器方法存在且命名正确、该字段在模型实例中被识别为可读属性（哪怕只是占位）——漏掉任一环，字段就不会出现在输出里。
append 字段不显示？先确认 $append 和获取器命名是否严格匹配
TP6 对大小写和命名格式极其敏感：$append = ['full_name'] 要求必须存在 getFullNameAttr() 方法（驼峰首字母大写，去掉下划线后每个单词首字母大写），而不是 getFullnameAttr() 或 get_full_name_attr()。常见错误是复制粘贴时漏掉中间大写，或把 status_text 对应成 getStatusTextAttr() 写成 getStatus_textAttr()。
-
$append是字符串数组，值只能是字段名，不能是方法名、表达式或带参数的调用 - 获取器方法必须是
public，且无参（TP 自动传入$value和$data） - 如果字段名含下划线，获取器前缀需转为驼峰；纯驼峰字段（如
fullName）则对应getFullNameAttr() - TP6.1+ 默认关闭自动识别获取器（
'auto_read' => false），即使命名对了也不会触发——必须确保模型没手动关掉这个开关
单条记录正常，集合 toArray() 后字段消失？这是 Collection 的默认行为
select() 返回的是 Collection 对象，它不会自动对每个模型实例调用 toArray()，因此 $append 不生效。你看到的只是原始数据，没走模型序列化流程。
- 正确做法是显式调用
$list->toArray()，而非依赖隐式转换 - 若需保留 Collection 链式操作，可用
$list->each(fn($item) => $item->toArray())强制逐个序列化 - 注意性能：N 条记录 × M 个
$append字段 = N×M 次获取器调用，别在获取器里查库或发 HTTP 请求 - TP5 中
append()方法是另一个东西（用于关联数据追加），和模型级$append属性无关，别混用
虚拟字段依赖关联数据却返回 null？获取器内访问未预加载的关联是高危操作
比如 getFullnameAttr() 里写了 $this->profile->real_name，但查询时没 with('profile')，TP 不会懒加载，$this->profile 就是 null，整个获取器返回 null，字段就“消失”了。
立即学习“PHP免费学习笔记（深入）”；
- 安全写法是用
$this->getData('profile')，它返回空对象/数组而非报错 - 更稳妥的方式是：只在明确需要时才让获取器依赖关联，并在控制器查询时强制
with('profile') - 避免在获取器里调
$this->xxx（触发其他获取器），改用$this->data['xxx']直接读原始值，防止递归或重复计算 - 字段值为空时，显式
return ''或return '-'，别靠 PHP 默认返回null，否则 TP 序列化可能跳过该字段
save() 时报 Unknown column 错误？虚拟字段没清理干净
模型里定义了 $append = ['full_name']，但又试图把它存进数据库——TP 不会自动过滤未在 $schema 中声明的字段，尤其当 $strict = false 时，save() 会把 full_name 当真实字段插入，直接报错。
- 务必在
save()前调用$model->remove('full_name')清除虚拟字段 - 或在模型中显式定义
protected $schema = ['id' => 'int', 'name' => 'string']，漏掉虚拟字段名，TP 会自动忽略 - 验证规则若针对虚拟字段（如
full_name），必须在beforeWrite钩子里动态追加，不能写死在$validate属性里 - 别在
initialize()里读取配置来动态设$append，此时 Config 可能还没加载完成
最常被忽略的一点：$append 字段不是“只要定义了获取器就能用”，它必须被模型内部识别为一个合法的可读属性——哪怕只是加一行 protected $full_name; 占位。没有这行，TP 就不会在 toArray() 阶段为你调用那个获取器。
