### Django Annotate 的使用方法 `annotate()` 是 Django ORM 提供的一个强大功能，允许开发者基于模型字段进行聚合计算并将其附加到查询结果中的每一项。以下是关于 `annotate()` 方法的具体介绍以及其实现方式。 #### 基本概念 `annotate()` 可以用来对查询集（QuerySet）中的每一条记录添加一个新的字段，该字段通常由某种聚合函数生成。例如，可以为每个作者统计他们所写书籍的数量[^1]。 #### 使用场景 当需要对一组数据进行分组操作，并针对这些分组应用某些聚合运算时，就可以使用 `annotate()` 函数。它常与 `group by` SQL 查询语句相对应[^2]。 #### 示例代码 下面是一个简单的例子来展示如何利用 `annotate()` 来实现基本的功能： ```python from django.db.models import Count, Avg # 统计每位作者写了多少本书籍 books_per_author = Author.objects.annotate(total_books=Count('book')) for author in books_per_author: print(f"{author.name} has written {author.total_books} book(s).") # 计算每种分类下的平均评分 average_rating_per_category = Category.objects.annotate(avg_rating=Avg('book__rating')) for category in average_rating_per_category: print(f"Category '{category.name}' avg rating is {category.avg_rating}.") ``` 以上代码片段展示了两个不同的应用场景：一个是通过 `Count` 聚合器获取每位作者的作品数量；另一个则是借助于 `Avg` 获取特定类别下图书的平均评价得分[^3]。 #### 结果解释 - **第一个示例**的结果会打印出每一位作者的名字及其对应的总书目数。 - **第二个示例**则列出了各个类别的名称和它们所属书籍的平均评级分数。 #### 高级用法 除了单独调用外，还可以与其他查询修饰符一起组合使用，比如过滤条件 (`filter`) 或者排序选项(`order_by`) 等等[^4]: ```python # 找出至少有两本书以上的所有作家，并按作品数目降序排列 popular_authors = Author.objects.filter(book__isnull=False)\ .annotate(num_books=Count('book'))\ .filter(num_books__gte=2)\ .order_by('-num_books') print([(a.name, a.num_books) for a in popular_authors]) ``` 此段脚本先筛选掉没有任何出版物的作者们，接着再标记他们的著作量，最后仅保留那些拥有超过或者等于两部作品的人选，并按照这个数值从高到底重新整理名单。 ---