如何在Django Admin中使用django_autocomplete_light实现外键自动补全？

1. 安装依赖 #

先安装django-autocomplete-light包：

pip install django-autocomplete-light

2. 配置项目settings.py #

将dal和dal_select2添加到INSTALLED_APPS，注意要放在django.contrib.admin之前：

INSTALLED_APPS = [
    'dal',
    'dal_select2',
    'django.contrib.admin',
    # 其他已注册的应用...
]

3. 创建自动补全视图 #

在你的应用目录下新建/编辑views.py，添加Country模型的自动补全视图：

from dal import autocomplete
from .models import Country
from django.db.models import Q

class CountryAutocomplete(autocomplete.Select2QuerySetView):
    def get_queryset(self):
        # 获取所有Country数据
        qs = Country.objects.all()
        
        # 根据用户输入的关键词过滤结果，支持名称和电话代码匹配
        if self.q:
            qs = qs.filter(
                Q(country_name__icontains=self.q) |
                Q(country_phone_code__icontains=self.q)
            )
        
        return qs

4. 配置URL路由 #

在项目或应用的urls.py中添加自动补全的路由：

from django.urls import path
from .views import CountryAutocomplete

urlpatterns = [
    # 其他已有的路由...
    path('country-autocomplete/', CountryAutocomplete.as_view(), name='country-autocomplete'),
]

5. 自定义State的Admin类 #

在admin.py中注册State模型时，通过autocomplete_fields指定需要自动补全的外键字段：

from django.contrib import admin
from .models import Country, State

class StateAdmin(admin.ModelAdmin):
    # 为country外键启用自动补全
    autocomplete_fields = ['country']
    # 可选：设置列表页显示字段，提升管理效率
    list_display = ('state_name', 'country', 'is_shipping_available')

# 注册模型
admin.site.register(Country)
admin.site.register(State, StateAdmin)

配置完成后，进入State的Admin新增/编辑页面，Country字段会变成带实时自动补全的输入框，输入国家名称或电话代码即可快速匹配对应选项。

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