软删除需同时满足模型使用SoftDeletes trait和数据表含deleted_at字段；默认查询自动排除已软删记录，查全部用withTrashed()，仅查已删用onlyTrashed()，restore()恢复，forceDelete()彻底删除。
软删除不是“删不掉”，而是
字段被设为当前时间，让模型自动从常规查询中隐身；没配对
trait 或漏加数据库字段，就根本不会生效。
如何启用 SoftDeletes 并添加 deleted_at 字段
必须同时满足两个条件：模型使用 trait、数据表含
字段。缺一不可，否则调用
仍是硬删除。
在迁移中添加字段：
，然后在
方法里写：
在模型中引入 trait：
并在类定义中声明：
注意：字段名固定为
，不能改；类型必须是
（
自动处理）
软删除后查询行为的变化
默认所有 Eloquent 查询（
、
）自动排除
的记录。这是通过全局
作用域
实现的，无需手动加
。
查已软删除的数据：用
—— 包含
和
的记录
只查已软删除的数据：用
—— 仅
可恢复单条或集合，它会把
设为
，不是重新插入
才是真正从数据库移除（跳过软删除逻辑）
常见踩坑点与兼容性注意
软删除不是魔法，很多地方需要显式干预，否则容易“以为删了，其实还在”或“想查却查不到”。
关联查询默认不穿透软删除：比如
不会自动过滤掉已软删除的 posts，除非
模型也启用了
并在关系定义中加
数据库约束冲突：如果表上有
约束（如
邮箱
唯一），软删除后重插同邮箱会报错 —— 因为记录物理还在，只是被隐藏了
索引建议：给
加索引，尤其当表数据量大且频繁执行
时，否则全表扫描很慢
API 返回时别忘了判断：直接
可能返回已被软删除的模型（比如通过 ID 强查），应主动检查
最常被忽略的是：软删除状态不影响模型实例的属性访问，
是可读可赋值的，但直接改它不会触发任何钩子或同步状态，必须用
或
才行。
deleted_atSoftDeletesdeleted_atdelete()php artisan make:migration add_deleted_at_to_users_table --table=usersup()$table->softDeletes();use Illuminate\Database\Eloquent\SoftDeletes;use SoftDeletes;deleted_attimestampsoftDeletes()User::all()User::where(...)->get()deleted_at IS NOT NULLwhereNull('deleted_at')withTrashed()deleted_at != nullnullonlyTrashed()deleted_at IS NOT NULLrestore()deleted_atNULLforceDelete()User::with('posts')PostSoftDeletes->withTrashed()UNIQUEdeleted_atwithTrashed()return $user$user->trashed()$user->deleted_atrestore()delete()