在 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。