Django：基于模型唯一值生成筛选器选项的实现方案

针对你需要动态获取模型中已存在的唯一国家作为筛选选项的需求，这里提供两种实用的实现方式：

方案一：重写FilterSet的__init__方法动态设置选项 #

通过在FilterSet初始化时查询最新的唯一国家列表，手动生成选项元组并赋值给筛选字段，确保每次页面加载都能获取最新数据：

import django_filters
from django import forms
from .models import cityModel

class cityFilter(django_filters.FilterSet):
    continent = django_filters.MultipleChoiceFilter(
        choices=cityModel.continent_choices,
        widget=forms.CheckboxSelectMultiple,
        label='Continent'
    )
    # 先定义country字段，暂不指定choices
    country = django_filters.MultipleChoiceFilter(
        widget=forms.CheckboxSelectMultiple,
        label='Country'
    )

    class Meta:
        model = cityModel
        fields = ['city', 'country', 'continent']

    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        # 查询并生成(值, 显示文本)格式的选项元组，按国家名排序
        country_options = [
            (item['country'], item['country']) 
            for item in cityModel.objects.values('country').distinct().order_by('country')
        ]
        # 动态更新country筛选器的选项
        self.filters['country'].extra['choices'] = country_options

方案二：使用ModelMultipleChoiceFilter（推荐） #

利用Django-Filters内置的ModelMultipleChoiceFilter，直接基于动态查询集生成选项，代码更简洁且符合Django惯例：

import django_filters
from django import forms
from .models import cityModel

class cityFilter(django_filters.FilterSet):
    continent = django_filters.MultipleChoiceFilter(
        choices=cityModel.continent_choices,
        widget=forms.CheckboxSelectMultiple,
        label='Continent'
    )
    country = django_filters.ModelMultipleChoiceFilter(
        # 用lambda包装查询集，确保每次实例化时都执行最新查询
        queryset=lambda: cityModel.objects.values_list('country', flat=True).distinct().order_by('country'),
        widget=forms.CheckboxSelectMultiple,
        label='Country',
        # 指定匹配的字段（因为我们直接用国家名字段值而非主键）
        to_field_name='country'
    )

    class Meta:
        model = cityModel
        fields = ['city', 'country', 'continent']

关键说明 #

• 不要直接在类定义中硬编码choices或queryset，否则只会在项目启动时加载一次数据，无法实时更新。
• 使用order_by('country')可以让筛选选项按字母顺序排列，提升用户体验。
• 如果你的country字段是外键类型，只需调整queryset为关联模型的查询集即可，无需手动处理选项格式。

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