如何让Django Admin的filter_horizontal搜索框同时匹配带特殊字符与无特殊字符的内容

嘿，这个问题我之前做项目时也碰到过，核心就是Django默认的搜索不会自动处理带重音的特殊字符，得手动做字符规范化匹配才能让两种输入都命中结果。下面给你两种实用的解决办法，你可以根据项目情况选：

这种方法是给酒庄模型加一个专门存储“无特殊字符版本名称”的字段，搜索时同时匹配原名称和规范化后的名称，优点是逻辑简单、查询速度快。

步骤1：安装字符转换库 #

先装个unidecode库，它能把带重音的字符转成普通ASCII字符（比如把Château转成Chateau）：

pip install unidecode

步骤2：修改酒庄模型 #

在你的酒庄模型里新增一个normalized_name字段，并且重写save方法，让它自动生成规范化后的名称：

from django.db import models
from unidecode import unidecode

class Winery(models.Model):
    name = models.CharField(max_length=255, verbose_name="酒庄名称")
    # 新增规范化字段，设置editable=False避免在Admin里被编辑
    normalized_name = models.CharField(max_length=255, editable=False)

    def save(self, *args, **kwargs):
        # 保存时自动生成无特殊字符的名称
        self.normalized_name = unidecode(self.name)
        super().save(*args, **kwargs)

    def __str__(self):
        return self.name

步骤3：更新Django Admin配置 #

把normalized_name加入Admin的search_fields里，这样搜索时会同时匹配原名称和规范化名称：

from django.contrib import admin
from .models import Winery

@admin.register(Winery)
class WineryAdmin(admin.ModelAdmin):
    filter_horizontal = ["你的关联字段"]  # 保留你原来的filter_horizontal配置
    search_fields = ["name", "normalized_name"]  # 新增normalized_name到搜索字段

如果不想给模型加额外字段，可以利用数据库的Unaccent函数，在搜索时同时对数据库字段和搜索关键词做去重音处理。这种方法需要你的数据库支持Unaccent功能（PostgreSQL、MySQL都支持，只是配置略有不同）。

步骤1：确保数据库支持Unaccent #

• PostgreSQL：需要先在数据库里创建unaccent扩展，执行SQL命令：

  CREATE EXTENSION unaccent;
  

• MySQL：默认支持UNACCENT函数（MySQL 8.0+版本），无需额外配置。

步骤2：自定义Admin的搜索逻辑 #

重写Admin的get_search_results方法，用Unaccent函数处理搜索关键词和字段：

from django.contrib import admin
from django.db.models import Q
# PostgreSQL用这个导入
from django.contrib.postgres.search import Unaccent
# 如果是MySQL，替换成下面的自定义Unaccent类：
# from django.db.models import Func
# class Unaccent(Func):
#     function = 'UNACCENT'

from .models import Winery

@admin.register(Winery)
class WineryAdmin(admin.ModelAdmin):
    filter_horizontal = ["你的关联字段"]
    search_fields = ["name"]  # 这里还是保留原字段，逻辑在get_search_results里处理

    def get_search_results(self, request, queryset, search_term):
        # 先调用父类的默认搜索逻辑
        queryset, use_distinct = super().get_search_results(request, queryset, search_term)
        
        if search_term:
            # 对搜索关键词和数据库字段都做去重音处理
            unaccented_search = Unaccent(search_term)
            # 用Q对象实现“原名称包含关键词”或“去重音后的名称包含去重音的关键词”
            queryset |= self.model.objects.filter(
                Q(name__icontains=search_term) |
                Q(Unaccent(name)__icontains=unaccented_search)
            )
        
        return queryset, use_distinct

两种方法都能实现你要的效果——不管输入带重音的Château还是不带的Chateau，都能搜到对应的酒庄数据。如果数据量不大，第一种方法最省心；要是不想加额外字段，就选第二种，记得根据你的数据库类型调整Unaccent的实现哦。

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