因为数据库gender字段存的是0/1/2整型值，PDO返回原始数字，TP不自动映射；需定义getGenderAttr访问器并用$map映射，注意方法名正确、调用方式为$model->gender且兼容null值。
为什么 $model->gender 直接输出 0/1/2 而不是“男/女/未知”
因为数据库字段 gender 存的是整型枚举值（如 0、1、2），PDO 返回的就是原始数字，ThinkPHP 不会自动映射成中文。访问器没生效，通常不是框架不支持，而是方法名写错了或调用方式不对。
-
getGenderAttr是 TP6 写法，_getGenderAttr是 TP5.1 必须的命名，写成getgenderAttr或getGenderattr都不会触发 - 只对模型属性访问有效：
$model->gender会走，$model->getData('gender')在 TP5.1 中不走，TP6 才支持 -
$model->toArray()在 TP6 中默认触发访问器，TP5.1 需确认是否启用了with关联或手动调用visible() - 字段值为
null时直接访问$map[$value]会报 notice，必须先判空
怎么写一个安全可靠的 gender 获取器
核心是明确映射关系、兼容空值、不干扰其他逻辑。别在获取器里做数据库操作或返回模型实例。
- 用
protected修饰（TP6 要求，TP5.1 兼容） - 参数只取
$value就够，不需要$data（除非要根据其他字段动态判断） - 映射数组建议定义为常量或私有属性，避免每次调用都重建
- 返回值必须是处理后的字符串或基础类型，不能是对象或
$this
protected function getGenderAttr($value)
{
$map = [0 => '未知', 1 => '男', 2 => '女'];
return $map[$value] ?? '未知';
}
关联模型中 gender 字段格式化失效怎么办
比如 $user->profile->gender 还是输出数字，不是中文——这不是访问器坏了，而是你只在 UserModel 里写了 getGenderAttr，而 ProfileModel 没写。
- 访问器只作用于定义它的那个模型类，不跨模型传递
- 如果
gender字段在profile表，就必须在ProfileModel里定义getGenderAttr -
with(['profile'])加载后，$user->profile是独立的ProfileModel实例，它用自己的访问器 - 不要试图在
UserModel里通过getProfileGenderAttr去“代理”处理，那属于逻辑错位
API 返回时 gender 显示为 null 或空字符串
常见于数据库该字段为 NULL，但访问器没处理，或者模型用了 $type = ['gender' => 'integer'] 导致 TP 先把 NULL 强转成 0，再传给 getGenderAttr(0)，结果返回了 “未知”，而业务本意是区分“未填写”和“未知”。
立即学习“PHP免费学习笔记（深入）”；
- 若需保留语义差异，别依赖
$type自动转换，改用访问器精细控制 - 显式判断
$value === null，返回空字符串或特定标记（如'__unset__'） - 前端若需统一兜底，建议后端返回
''而非null，避免 JSON 中出现"gender": null - 测试时用
dump($model->toArray())和dump($model->gender)对比，确认访问器是否被调用
getData() 或 Db::name() 的结果。最容易忽略的，是以为写了一个 getGenderAttr 就万事大吉，却忘了它只在 $model->gender 这种点语法下才运行。 
