如何自定义Django Admin搜索功能，添加可选搜索字段的下拉选择框

Django Admin 没有内置参数可以直接实现「下拉选择指定检索字段」的需求，默认提供的 search_fields 配置仅支持对预设的所有字段做全局模糊匹配，不支持前端手动选择检索范围的交互。你可以通过以下两种方案实现需求：

方案1：无第三方依赖的自定义实现 #

仅需修改Admin逻辑和少量模板代码即可实现，适合不想引入额外依赖的场景：

• 第一步：重写对应ModelAdmin的get_search_results方法，新增对前端传递的搜索字段参数的校验和查询逻辑，注意要做字段合法性校验避免注入风险
• 第二步：复制Django Admin原生的change_list.html模板到你的应用对应目录templates/admin/[你的应用名]/[你的模型名]/下，在原有搜索表单内新增下拉选择框，提交时同步传递选中的字段值即可

核心代码示例：

from django.contrib import admin
from .models import YourModel

class YourModelAdmin(admin.ModelAdmin):
    # 配置允许用户搜索的字段：字段名→前端展示名
    allowed_search_fields = {
        "name": "姓名",
        "mobile": "手机号",
        "email": "邮箱地址"
    }

    def get_search_results(self, request, queryset, search_term):
        search_field = request.GET.get("search_field", "")
        # 仅当选中合法字段且有搜索关键词时走单字段搜索逻辑
        if search_field in self.allowed_search_fields and search_term:
            queryset = queryset.filter(**{f"{search_field}__icontains": search_term})
            return queryset, False
        # 未指定字段时走默认搜索逻辑
        return super().get_search_results(request, queryset, search_term)

模板新增下拉框示例（插入到搜索表单的<form>标签内即可）：

<select name="search_field">
  <option value="">全部字段</option>
  {% for field_val, field_name in cl.model_admin.allowed_search_fields.items %}
  <option value="{{ field_val }}" {% if request.GET.search_field == field_val %}selected{% endif %}>
    {{ field_name }}
  </option>
  {% endfor %}
</select>

方案2：第三方包快速实现 #

如果需要更丰富的搜索能力（比如多条件组合搜索、字段类型自动适配），可以直接使用成熟的社区扩展，比如django-admin-search，安装后仅需少量配置即可实现需求，无需手动修改模板。

配置示例：

from django_admin_search.admin import AdvancedSearchAdmin
from .models import YourModel

class YourModelAdmin(AdvancedSearchAdmin):
    # 配置允许搜索的字段和匹配规则
    advanced_search_fields = {
        "name": ["icontains"],
        "mobile": ["icontains"],
        "email": ["icontains"],
        "create_time": ["gte", "lte"]
    }

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