django model Manager
🧩 一、Manager 是什么？
Manager 是 Django ORM 提供的数据库操作接口。
每个模型（Model）默认都有一个管理器 objects，用于执行所有数据库查询。
class Article(models.Model):title = models.CharField(max_length=100)# 默认存在一个 Manager
Article.objects.all() # 查询所有文章
Article.objects.filter(...) # 过滤
✅ Django 在每个 Model 类中自动添加一个 objects = models.Manager()。
你可以通过它访问 ORM 提供的所有方法（filter(), get(), create(), update(), 等）。
🧠 二、Manager 的主要作用
| 功能 | 示例 |
|---|---|
| 定义默认查询范围 | 限制返回的对象（如只显示已发布内容） |
| 添加自定义查询方法 | 封装复杂查询逻辑 |
| 控制默认行为 | 指定模型默认返回什么数据 |
| 逻辑复用 | 让过滤逻辑集中，不重复写在 view 或 service 里 |
⚙️ 三、定义自定义 Manager
✅ 基本结构
from django.db import modelsclass PublishedManager(models.Manager):def get_queryset(self):# 定义默认返回的数据范围return super().get_queryset().filter(is_published=True)
然后在模型中使用它：
class Article(models.Model):title = models.CharField(max_length=100)is_published = models.BooleanField(default=False)# 默认管理器objects = models.Manager()# 自定义管理器published = PublishedManager()
📖 使用效果：
Article.objects.all() # 所有文章
Article.published.all() # 只返回已发布的文章
🧩 四、get_queryset() 方法详解
get_queryset() 是 Manager 的核心方法，用来定义默认查询集（QuerySet）。
Django 的所有 ORM 操作最终都是基于这个 QuerySet。
示例：
class ActiveUserManager(models.Manager):def get_queryset(self):return super().get_queryset().filter(is_active=True)
使用：
User.active.all() # 只返回活跃用户
User.objects.all() # 所有用户
🔧 五、添加自定义查询方法
你可以在 Manager 中添加业务逻辑方法。
class ArticleManager(models.Manager):def published(self):return self.get_queryset().filter(is_published=True)def recent(self):return self.get_queryset().order_by('-created_at')[:5]
使用：
Article.objects.published() # 只返回发布的文章
Article.objects.published().recent() # 最近5篇已发布文章
💡 六、与自定义 QuerySet 结合使用（推荐做法）
Django 推荐将复杂查询逻辑放入自定义 QuerySet，再让 Manager 使用它。
class ArticleQuerySet(models.QuerySet):def published(self):return self.filter(is_published=True)def recent(self):return self.order_by('-created_at')
然后定义 Manager：
class ArticleManager(models.Manager):def get_queryset(self):return ArticleQuerySet(self.model, using=self._db)# 让 Manager 支持链式调用def published(self):return self.get_queryset().published()
模型：
class Article(models.Model):title = models.CharField(max_length=100)is_published = models.BooleanField(default=False)created_at = models.DateTimeField(auto_now_add=True)objects = ArticleManager()
📖 调用：
Article.objects.published().recent()
✅ 优点：
- 支持链式调用
- QuerySet 与 Manager 逻辑分层更清晰
- 更容易测试与复用
🧱 七、多个 Manager 的应用场景
你可以为同一个模型定义多个 Manager，用于不同业务场景：
class Article(models.Model):title = models.CharField(max_length=100)is_published = models.BooleanField(default=False)objects = models.Manager() # 默认管理器published = PublishedManager() # 只看发布的
🔐 八、Manager 与默认行为
- Django 的通用视图（如
ListView）默认使用模型的 第一个定义的 Manager。 - 如果你想让某个自定义 Manager 成为默认管理器，只需把它放在第一个位置：
class Article(models.Model):published = PublishedManager() # 默认被使用objects = models.Manager()
🧰 九、实际应用案例
✅ 示例1：用户权限过滤
class UserQuerySet(models.QuerySet):def active(self):return self.filter(is_active=True)def staff(self):return self.filter(is_staff=True)class UserManager(models.Manager):def get_queryset(self):return UserQuerySet(self.model, using=self._db)def active(self):return self.get_queryset().active()
User.objects.active().staff()
✅ 示例2：软删除模型
class SoftDeleteManager(models.Manager):def get_queryset(self):return super().get_queryset().filter(is_deleted=False)class Post(models.Model):title = models.CharField(max_length=100)is_deleted = models.BooleanField(default=False)objects = SoftDeleteManager()all_objects = models.Manager() # 可访问已删除的
🧭 十、Manager 与 signals、admin、views 的结合
在 admin 中使用自定义 Manager：
class ArticleAdmin(admin.ModelAdmin):def get_queryset(self, request):return Article.published.all()
在 views 中使用：
def index(request):articles = Article.objects.published().recent()return render(request, 'index.html', {'articles': articles})
✅ 总结表
| 概念 | 作用 |
|---|---|
| Manager | ORM 查询接口，用于操作数据库 |
| get_queryset() | 定义默认查询集 |
| 自定义方法 | 封装业务查询逻辑 |
| 自定义 QuerySet | 支持链式调用、逻辑复用 |
| 多个 Manager | 用于区分不同数据视图（如软删除、发布状态） |