Django Admin自定义查询集：实现用户仅归属单个用户组

要实现「用户只能归属一个组」且在后台能正常添加/移除用户的需求，你需要调整formfield_for_manytomany的查询集，同时添加保存时的唯一性校验逻辑，具体如下：

1. 修复后台多选框的用户显示问题 #

修改UserGroupAdmin的formfield_for_manytomany方法，区分新增和编辑场景：

• 新增用户组时，仅显示未归属任何组的用户
• 编辑用户组时，显示未归属任何组的用户 + 当前组内的用户（保证已选用户能正常显示，支持移除操作）

代码实现：

from django.db.models import Q
from django.contrib import admin
from .models import UserGroup

class UserGroupAdmin(admin.ModelAdmin):
    list_display = ('name',)
    search_fields = ('name',)
    filter_horizontal = ('users',)

    def formfield_for_manytomany(self, db_field, request, **kwargs):
        if db_field.name == 'users':
            # 获取当前编辑的用户组实例（新增时instance为None）
            instance = self.get_object(request, request.GET.get('object_id'))
            if instance:
                # 编辑状态：未分组用户 + 当前组内用户
                kwargs['queryset'] = User.objects.filter(
                    Q(usergroup__isnull=True) | Q(usergroup=instance)
                ).distinct()
            else:
                # 新增状态：仅未分组用户
                kwargs['queryset'] = User.objects.filter(usergroup__isnull=True)
        return super().formfield_for_manytomany(db_field, request, **kwargs)

admin.site.register(UserGroup, UserGroupAdmin)

2. 强制用户组唯一性（避免通过其他途径添加到多组） #

仅靠后台查询集限制不够，还需要在保存用户组时，自动将新增的用户从原有组中移除，确保一个用户只在一个组里：

class UserGroupAdmin(admin.ModelAdmin):
    # 保留上面的list_display、search_fields、filter_horizontal和formfield_for_manytomany方法

    def save_model(self, request, obj, form, change):
        # 获取本次新增的用户（提交的用户集合减去之前的用户集合）
        if change:
            old_users = obj.users.all()
            new_users = form.cleaned_data['users']
            added_users = new_users - old_users
            # 对新增的用户，移除他们原有的所有组
            for user in added_users:
                user.usergroup_set.clear()
        super().save_model(request, obj, form, change)

说明 #

• 第一部分的查询集调整，解决了编辑时无法看到当前组用户、无法移除的问题
• 第二部分的save_model重写，确保用户被添加到新组时自动脱离原有组，严格满足「用户只能归属一个组」的需求
• 这种方案不需要修改User模型，符合你的要求

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