Django Admin：如何区分关联不同Usage的同名SubUsage选项？

针对你遇到的SubUsage重名无法区分所属Usage的问题，有以下几种实用解决办法：

1. 重写SubUsage的__str__方法 #

直接修改SubUsage模型的字符串表示，让它包含所属Usage的名称，这样在Admin选择框里就能直观看到每个SubUsage对应的归属。

修改SubUsage模型代码：

class SubUsage(models.Model):
    # 原有字段保持不变
    id = models.UUIDField(
        primary_key=True,
        default=uuid.uuid4,
        editable=False,
    )
    sub_usage_name = models.CharField(
        max_length=255,
        null=False,
        blank=False,
    )
    usage = models.ForeignKey(
        Usage,
        on_delete=models.CASCADE,
    )

    # 添加__str__方法
    def __str__(self):
        return f"{self.usage.usage_name} - {self.sub_usage_name}"

修改后，Admin里的SubUsage选择项会显示类似「办公设备 - 打印机」这样的格式，彻底区分重名的SubUsage。

2. 在Django Admin中对SubUsage进行分组显示 #

如果希望选择框更结构化，可以自定义SubUsage的选择部件，按Usage分组展示。

在admin.py中自定义表单逻辑：

from django import forms
from django.contrib import admin
from django.contrib.admin.widgets import FilteredSelectMultiple
from .models import Product, SubUsage

class ProductAdminForm(forms.ModelForm):
    sub_usage = forms.ModelMultipleChoiceField(
        queryset=SubUsage.objects.all(),
        widget=FilteredSelectMultiple("SubUsage", is_stacked=False),
        required=False,
    )

    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        # 按Usage分组整理选项
        grouped_choices = {}
        for sub_usage in SubUsage.objects.select_related('usage').order_by('usage__usage_name', 'sub_usage_name'):
            usage_name = sub_usage.usage.usage_name
            if usage_name not in grouped_choices:
                grouped_choices[usage_name] = []
            grouped_choices[usage_name].append((sub_usage.id, sub_usage.sub_usage_name))
        self.fields['sub_usage'].widget.choices = [(k, v) for k, v in grouped_choices.items()]

@admin.register(Product)
class ProductAdmin(admin.ModelAdmin):
    form = ProductAdminForm
    filter_horizontal = ('usage', 'sub_usage')

设置后，SubUsage的选择框会按Usage名称分组，展开对应组才能看到下属的SubUsage，结构更清晰。

3. 实现Usage与SubUsage的联动过滤（进阶） #

如果想彻底避免误选，可在Admin表单中实现联动：当选择某个Usage后，SubUsage仅显示该Usage下的选项。

在admin.py的ProductAdmin中引入自定义JS：

@admin.register(Product)
class ProductAdmin(admin.ModelAdmin):
    filter_horizontal = ('usage', 'sub_usage')

    class Media:
        js = ('admin/js/subusage_filter.js',)

然后在项目的static/admin/js/目录下创建subusage_filter.js文件，内容如下：

document.addEventListener('DOMContentLoaded', function() {
    const usageSelect = document.getElementById('id_usage');
    const subUsageSelect = document.getElementById('id_sub_usage');
    const originalSubUsageOptions = Array.from(subUsageSelect.options);
    
    // 提前构建SubUsage ID到所属Usage ID的映射（从选项文本拆分，前提是已修改__str__方法）
    const subUsageToUsageMap = {};
    originalSubUsageOptions.forEach(opt => {
        const parts = opt.text.split(' - ');
        if (parts.length === 2) {
            // 这里需要后端传递Usage名称对应ID的映射，示例中假设已通过模板变量注入
            const usageId = window.usageNameToId[parts[0]];
            subUsageToUsageMap[opt.value] = usageId;
        }
    });

    usageSelect.addEventListener('change', function() {
        const selectedUsageIds = Array.from(usageSelect.selectedOptions).map(opt => opt.value);
        
        // 清空现有选项，重新添加符合条件的SubUsage
        subUsageSelect.innerHTML = '';
        originalSubUsageOptions.forEach(opt => {
            if (selectedUsageIds.includes(subUsageToUsageMap[opt.value])) {
                subUsageSelect.appendChild(opt.cloneNode(true));
            }
        });
    });
});

注意：需要在Admin模板中注入window.usageNameToId变量，比如通过重写ProductAdmin的change_form_template方法，传递所有Usage的名称与ID映射，实现精准的联动过滤，从根源上避免选择不属于已选Usage的SubUsage。

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