Cl4全局过滤软删除数据的核心是自动跳过deleted_at非空记录以保留历史可追溯性，统一字段设计（推荐deleted_at）、框架层自动注入过滤条件、提供绕过机制及添加索引优化性能。
Cl4 全局过滤软删除数据，核心是让查询自动跳过标记为“已删除”的记录，而不是真正从数据库物理删掉它们。这既保留了历史数据可追溯性，又避免业务逻辑反复写 WHERE deleted_at IS NULL 这类条件。
软删除字段设计要统一
确保所有启用软删除的表都包含标准字段，比如 deleted_at（datetime 类型，NULL 表示未删）或 is_deleted（boolean，默认 false）。推荐用 deleted_at，便于审计和恢复。字段名一旦选定，就在整个项目中保持一致，后续全局过滤才好统一识别。
框架层自动注入过滤条件
以主流 ORM 为例：
- Laravel Eloquent：在模型中启用
SoftDeletestrait，它会自动在所有查询中排除deleted_at IS NOT NULL的记录。 - Django：通过自定义 Manager 实现
objects = NonDeletedManager()，重写get_queryset()加入filter(deleted_at__isnull=True)。 - .NET Entity Framework Core：使用全局查询过滤器（Global Query Filter），在
OnModelCreating中配置modelBuilder.Entity<T>().HasQueryFilter(x => x.DeletedAt == null)。
关键点是——这个过滤必须在数据访问最底层生效，不能靠上层业务代码手动加条件，否则容易遗漏。
特殊场景需显式绕过过滤
有些操作需要查包括已删的数据，比如回收站列表、审计日志、数据恢复。这时应提供明确的绕过方式：
- Laravel 提供
withTrashed()和onlyTrashed()方法 - EF Core 可用
IgnoreQueryFilters()临时禁用 - 自研框架建议设计类似
.IncludeDeleted()的链式调用
避免用 where raw 或直接拼 SQL 绕过，破坏统一性。
索引与性能注意
软删除字段参与高频查询，务必加索引。例如：
CREATE INDEX idx_users_deleted_at ON users(deleted_at);
否则随着数据增长，全表扫描会拖慢所有查询。同时注意 deleted_at IS NULL 条件是否能被索引有效利用，必要时用函数索引或部分索引优化。
不复杂但容易忽略。
