makeVisible() 用于临时解禁模型中被 $hidden 或 $casts 隐藏的字段（如 password_hash），仅作用于当前实例，支持字符串或数组传参，不影响模型定义；append() 则用于动态添加计算字段，不受 $hidden 限制，但需注意性能与空值处理。
用 makeVisible() 临时显示隐藏字段
模型里通过 $hidden 或 $casts 隐藏的字段（比如 password_hash、api_token），默认不会出现在 JSON 或 toArray() 结果中。想在某个接口或调试时临时暴露，直接调 makeVisible() 最快。
它只影响当前实例，不改模型定义，也不污染后续操作：
use App\Models\User; $user = User::find(1); // 此时 $user->toArray() 不含 password_hash $user->makeVisible(['password_hash']); // 现在 toArray() 和 toJson() 会包含 password_hash
- 支持传数组或字符串，多个字段写成
['field1', 'field2'] - 对已加载关系（
with()）无效，得单独对关联模型再调一次 - 如果字段被
$casts设为array或object，且本身是 null，makeVisible()不会“复活”它——得先确保字段有值
用 append() 动态加字段，绕过隐藏逻辑
makeVisible() 是“解禁”，而 append() 是“强行塞进去”。适合你想加一个原本就不在模型属性里的字段（比如计算字段、拼接字段），或者字段名和隐藏字段冲突但你又不想动 $hidden。
例如，模型里 $hidden = ['password_hash']，但你要在某个 API 返回 password_preview（只显示前 4 位）：
$user = User::find(1)->append('password_preview');
// 在模型里定义访问器：
public function getPasswordPreviewAttribute()
{
return substr($this->password_hash ?? '', 0, 4) . '***';
}
-
append()加的字段不受$hidden影响，哪怕字段名和隐藏字段一样也会出现（但值来自访问器） - 注意性能：每个
append字段都会触发一次访问器调用，别在循环里对大量模型用 - 如果访问器返回 null，字段仍会出现在 JSON 中（值为
null），要过滤得手动处理
避免在响应前漏掉 makeVisible() 导致字段始终缺失
常见错误是写了 makeVisible()，但没作用在最终输出的对象上。比如：
$user = User::find(1); $user->makeVisible(['token']); // ✅ 对 $user 生效 return response()->json($user); // ✅ 正确 // ❌ 错误写法： $user = User::find(1)->makeVisible(['token']); // 返回的是新实例？不，Laravel 这里是链式调用，但 makeVisible 返回 $this，所以这行没问题 // 但真正容易错的是： $users = User::all(); $users->makeVisible(['token']); // ❌ $users 是集合，makeVisible 不作用于整个集合 // 得这么写： $users = User::all()->map->makeVisible(['token']);
- 集合（
Collection）没有makeVisible()方法，必须用map或遍历每个模型 - API 资源类（
Resource）里，默认会尊重模型的$hidden，想覆盖得在资源类里重写toArray()或用makeVisible()处理$this->resource - 测试时容易忽略：Tinker 里调了
makeVisible()，但忘了toJson()才真正触发序列化，直接dd($user)看不到效果
别混淆 setVisible() 和 makeVisible()
setVisible() 是“只留这些字段”，不是“额外显示”。它会清空所有其他字段（包括没在 $hidden 里的），只保留你指定的列表。一不小心就把整个模型数据砍没了。
$user = User::find(1); $user->setVisible(['name', 'email']); // ❌ 除了 name 和 email，其他全消失，包括 id、created_at 等 // 如果你只是想多露一个字段，绝对别用这个
-
makeVisible()是加法，setVisible()是减法+重置，语义完全不同 - 文档里这两个方法离得很近，看错一行就出事
- 没有
makeHidden()这种反向操作，想临时隐藏得靠资源类或手动 unset
