在Django Admin中添加语言排除筛选器的高效实现方法

现有模型定义如下：

class Follower(models.Model):
   language = models.ManyToManyField(
        "instagram_data.Language", verbose_name=_("language_code_name"), blank=True)

class Language(models.Model):
    code_name = models.CharField(max_length=6,
                                 null=True,
                                 blank=True,
                                 unique=True,
                                 db_index=True,
                                 verbose_name='language_code_name')

    def __str__(self):
        return self.code_name

已通过('language__code_name', MultiSelectDropdownFilter)实现包含指定语言的筛选，现在需要添加排除指定语言的筛选功能，同时保证查询性能，具体实现方式如下：

1. 自定义排除型多选择筛选类 #

继承已使用的MultiSelectDropdownFilter，重写查询逻辑实现排除效果：

from django.contrib import admin
from django.utils.translation import gettext_lazy as _
from admin_multiselect_filter.filters import MultiSelectDropdownFilter  # 根据实际使用的包调整

class ExcludeLanguageMultiSelectFilter(MultiSelectDropdownFilter):
    title = _("排除语言")  # 筛选器显示名称
    parameter_name = "exclude_language"  # 唯一参数名，避免和现有筛选冲突

    def queryset(self, request, queryset):
        selected_codes = self.value()
        if selected_codes:
            # 排除关联了指定语言的Follower，distinct()避免多对多关联导致的重复结果
            return queryset.exclude(language__code_name__in=selected_codes).distinct()
        return queryset

2. 在Admin类中注册筛选器 #

将自定义筛选器添加到list_filter配置中：

class FollowerAdmin(admin.ModelAdmin):
    list_filter = [
        ('language__code_name', MultiSelectDropdownFilter),  # 原有包含筛选
        ('language__code_name', ExcludeLanguageMultiSelectFilter),  # 新增排除筛选
    ]
    # 其他Admin配置项...

3. 性能保障说明 #

• 由于Language模型的code_name字段已设置db_index=True，language__code_name__in的查询会直接走数据库索引，不会产生全表扫描，性能可控。
• 使用exclude结合distinct()，既保证了结果的准确性（移除关联指定语言的记录），又避免了多对多关联查询带来的重复数据问题。

注意事项 #

• 若使用的是其他第三方多选择筛选组件，只需调整自定义类的继承父类，核心的queryset重写逻辑保持一致即可。
• 确保parameter_name与现有筛选的参数名不重复，防止请求参数冲突导致筛选逻辑异常。

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