Django双下划线查询

在 Django 中，双下划线（__）查询是一种强大的语法，用于在 ORM（对象关系映射）中跨关联模型进行字段查询，或使用内置查询表达式（如过滤、聚合等）。以下是其核心用法和示例：

1. 跨关联模型查询

通过双下划线可以引用关联模型（ForeignKey、ManyToManyField、OneToOneField）的字段。

示例模型：

复制代码

class Author(models.Model):
    name = models.CharField(max_length=100)

class Book(models.Model):
    title = models.CharField(max_length=100)
    author = models.ForeignKey(Author, on_delete=models.CASCADE)

查询示例：

复制代码

# 查询作者名为"Alice"的所有书籍
books = Book.objects.filter(author__name="Alice")

# 查询所有写过标题包含"Python"的书籍的作者
authors = Author.objects.filter(book__title__icontains="Python")

2. 字段查找表达式

双下划线后可接多种查询表达式，如：
比较运算符

exact：精确匹配（默认）

gt、gte、lt、lte：大于、大于等于、小于、小于等于

in：包含在列表中

range：范围查询

示例：

复制代码

# 查询价格大于100的产品
products = Product.objects.filter(price__gt=100)

# 查询ID为1、3、5的用户
users = User.objects.filter(id__in=[1, 3, 5])

字符串处理

contains、icontains：包含（区分 / 不区分大小写）

startswith、istartswith：以... 开头

endswith、iendswith：以... 结尾

regex、iregex：正则表达式匹配

示例：

复制代码

# 查询邮箱以"@gmail.com"结尾的用户
users = User.objects.filter(email__endswith="@gmail.com")

日期和时间处理

year、month、day：提取日期部分

hour、minute、second：提取时间部分

date：日期比较

time：时间比较

示例：

复制代码

# 查询2023年创建的订单
orders = Order.objects.filter(created_at__year=2023)

# 查询昨天创建的所有对象
from datetime import date, timedelta
yesterday = date.today() - timedelta(days=1)
objects = MyModel.objects.filter(created_at__date=yesterday)

空值和布尔值

isnull：是否为空（True/False）

exact：布尔值匹配

示例：

复制代码

# 查询没有关联图片的文章
articles = Article.objects.filter(image__isnull=True)

# 查询已发布的文章
articles = Article.objects.filter(is_published__exact=True)

3. 多级跨关联查询

可以通过多个双下划线连接多层关联模型。

示例模型：

复制代码

class Country(models.Model):
    name = models.CharField(max_length=100)

class City(models.Model):
    name = models.CharField(max_length=100)
    country = models.ForeignKey(Country, on_delete=models.CASCADE)

class User(models.Model):
    name = models.CharField(max_length=100)
    city = models.ForeignKey(City, on_delete=models.CASCADE)

查询示例：

复制代码

# 查询来自中国北京的所有用户
users = User.objects.filter(city__name="Beijing", city__country__name="China")

4. 聚合查询与双下划线

在聚合函数（如Sum、Avg）中也可使用双下划线跨模型引用字段。

示例：

复制代码

from django.db.models import Sum
# 计算每个作者的总书籍销量
authors = Author.objects.annotate(total_sales=Sum("book__sales"))

注意事项

性能问题：多级跨关联可能导致 SQL 查询复杂度增加，建议结合select_related()或prefetch_related()优化。

反向关联：通过关联模型反向查询时，默认使用模型名小写加_set（如author.book_set.all()），但在双下划线查询中可直接使用模型名小写（如author__name）。

空值处理：使用跨关联查询时，若关联对象不存在，查询结果可能为空，需谨慎处理。

通过双下划线查询，Django ORM 可以简洁地表达复杂的数据库查询逻辑，避免编写原生 SQL。