如何合并带rank注解与无rank注解的Django QuerySet？

核心方案：给filename查询添加固定rank注解 #

完全可以给filename的查询集添加rank字段，让两个查询集的列数一致，就能用union合并，还能通过rank值控制排序优先级（比如让filename结果排顶部）。

具体实现步骤 #

1. 导入必要依赖

from django.contrib.postgres.search import SearchQuery, SearchRank
from django.db.models import Value, FloatField, F

2. 构建搜索查询

query = SearchQuery("space")

3. 处理带rank的title搜索

title_results = Song.objects.annotate(
    rank=SearchRank(F('title_vector'), query)
).filter(title_vector=query)

4. 给filename搜索添加固定rank

给filename的结果设置一个比title搜索rank更高的固定值（比如10.0，因为SearchRank默认结果范围是0-4），确保filename结果排在最前面：

file_results = Song.objects.filter(
    filename__icontains=query
).annotate(rank=Value(10.0, output_field=FloatField()))

5. 合并查询集并排序

用union合并两个查询集（默认自动去重），再按rank降序排序：

combined_results = (title_results.union(file_results)).order_by('-rank')

这样combined_results是标准的Django QuerySet，模板可直接遍历处理，无需传递多个列表。

备选方案：内存中合并列表 #

如果不想用数据库层面的union，可将两个查询集转为列表后手动合并、去重、排序：

# 转成列表
title_list = list(title_results)
file_list = list(file_results)

# 给filename结果添加rank属性
for song in file_list:
    song.rank = 10.0

# 合并并去重
seen_ids = set()
unique_combined = []
for song in file_list + title_list:
    if song.id not in seen_ids:
        seen_ids.add(song.id)
        unique_combined.append(song)

# 按rank降序排序
unique_combined.sort(key=lambda x: x.rank, reverse=True)

这种方式适合数据量较小的场景，缺点是无法使用Django QuerySet的分页、懒加载等特性。

内容的提问来源于stack exchange，提问作者Mark Abersold