如何使用Django的_count()方法和aggregate函数进行数据数量统计？

本文共计696个文字，预计阅读时间需要3分钟。

直接调用`QuerySet.count()`是常用的计数方法，它生成一条`COUNT(*)`的SQL语句，不将对象加载到内存。然而，许多人会在`for`循环中重复调用，如下所示：

aggregate() 适合带条件或组合统计，但不能链式调用 filter

aggregate() 返回字典，用于单次聚合计算，比如总和、最大值、计数（带条件）。但它返回的是一个结果字典，不是 QuerySet，所以不能接 filter()、order_by() 等方法。

• 错误写法：User.objects.aggregate(count=Count('id')).filter(is_active=True) → 报错 AttributeError: 'dict' object has no attribute 'filter'
• 正确写法：条件必须写在 aggregate() 前的 QuerySet 上，如 User.objects.filter(is_active=True).aggregate(count=Count('id'))
• 想同时算多个指标？传多个 Count、Avg 等，比如 .aggregate(active=Count('id', filter=Q(is_active=True)), total=Count('id'))

Count('field') 和 Count('*') 在 NULL 上行为不同

Count('field') 默认忽略 NULL 值，而 Count('*') 或 Count(1) 统计所有行。比如统计有邮箱的用户数：User.objects.aggregate(email_count=Count('email')) 不会把 email=None 的行算进去；但如果你想要所有用户数，得用 Count('id') 或显式写 Count('*')（Django 3.2+ 支持）。另外，Count('field', distinct=True) 可去重，但注意它只对关联字段或外键有意义，对普通字段去重通常不是你想要的效果。

annotate() 才是“给每条记录加个 count 字段”的正解

如果目标是“查出每个用户有多少篇文章”，必须用 annotate()，不是 aggregate()。

• aggregate() → 返回一个字典，整个 QuerySet 就一个总数
• annotate() → 返回 QuerySet，每条记录多一个字段，比如 User.objects.annotate(post_count=Count('post'))
• 注意关联名大小写：字段名是模型中定义的 related_name，不是表名；没设的话默认是 小写模型名_set
• 如果用了 select_related 或 prefetch_related，再加 annotate 要小心重复计数（JOIN 导致行膨胀），此时应加 distinct=True，如 Count('post', distinct=True)

真正容易卡住的地方，往往不是语法，而是搞混了 aggregate 和 annotate 的作用域——前者是“全表汇总”，后者是“逐行打标”。一旦在列表页里错用 aggregate，就只能拿到一个数字，而不是每条数据都带统计值。