如何按Django CharField的选项文本而非键进行过滤？

这个问题其实很常见——因为Django的choices字段在数据库里只存了选项的键（比如'FI'），而显示用的文本（'First'）只是Python层面的映射，数据库里根本没存这些文本，所以直接用choiceField__contains自然搜不到文本内容。下面给你几个实用的解决办法：

方法一：Python层面匹配文本，再过滤对应键 #

这是最直接的办法，先在Python里找出所有文本包含查询字符串的选项键，再用这些键去过滤数据库：

from django.db.models import Q

# 假设这是用户输入的查询字符串
query = 'third'  # 或者比如'ir'这种部分匹配的字符串

# 遍历CHOICES，找出所有文本包含query的选项键（忽略大小写）
matching_keys = [
    key for key, text in Model.CHOICES
    if query.lower() in text.lower()
]

# 用匹配到的键过滤数据
results = Model.objects.filter(choiceField__in=matching_keys)

这个方法的优点是不用改数据库结构，代码简单，适合选项数量不多的场景。

方法二：新增字段存储选项文本，直接数据库过滤 #

如果你的选项比较多，或者查询频率很高，可以考虑在模型里新增一个字段专门存储选项文本，然后直接用这个字段做过滤：

class Model(models.Model):
    CHOICES = ( ('FI', 'First'), ('SE', 'Second'), ('TH', 'Third') )
    choiceField = models.CharField(max_length=2, choices=CHOICES)
    # 新增字段存储选项文本
    choice_text = models.CharField(max_length=50)

    def save(self, *args, **kwargs):
        # 保存时自动同步选项文本
        self.choice_text = dict(self.CHOICES)[self.choiceField]
        super().save(*args, **kwargs)

之后就可以直接用文本做模糊匹配了：

results = Model.objects.filter(choice_text__icontains=query)

这个方法的优点是查询效率高，还可以给choice_text字段加索引优化性能；缺点是需要冗余存储数据，而且如果后续修改了CHOICES，需要手动更新历史数据的choice_text字段。

方法三：用annotate动态生成文本字段过滤 #

如果不想新增数据库字段，也可以在查询时用annotate动态生成选项文本，再做过滤：

from django.db.models import Case, Value, CharField, When

results = Model.objects.annotate(
    # 动态生成选项文本字段
    choice_text=Case(
        When(choiceField='FI', then=Value('First')),
        When(choiceField='SE', then=Value('Second')),
        When(choiceField='TH', then=Value('Third')),
        output_field=CharField(),
    )
).filter(choice_text__icontains=query)

这个方法的好处是不用修改模型结构，缺点是如果CHOICES选项很多，Case语句会变得很长，而且每次查询都要动态生成文本，性能上不如直接存储字段。

你可以根据自己的场景选择最合适的方法~

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