Django-Unfold项目中多标签内联表单的解决方案

在Django-Unfold项目中，开发者在使用TabularInline时可能会遇到一个常见问题：当尝试在管理后台创建多个标签页内联表单时，所有内联表单内容会错误地显示在同一个标签页中，而不是按照预期分布在不同的标签页上。

问题现象

开发者通常会这样定义内联表单：

class Inline1(TabularInline):
    model = Model1
    tab = True

class Inline2(TabularInline):
    model = Model2
    tab = True

@admin.register(MyModel)
class MyModelAdmin(ModelAdmin):
    inlines = [Inline1, Inline2]

理论上，这应该生成两个独立的标签页，每个标签页显示对应的内联表单内容。但实际上，所有内联表单内容都会出现在第一个标签页中。

问题根源

经过深入分析，这个问题主要源于以下两个因素：

1. URL参数编码问题：当模型的verbose_name或verbose_name_plural包含非拉丁字符时，会导致URL参数编码错误，使得标签页切换功能失效。

2. 标签页识别机制：Django-Unfold依赖内联表单的verbose_name作为URL参数来识别不同的标签页，当这个值不明确或包含特殊字符时，系统无法正确区分不同的内联表单。

解决方案

针对这个问题，我们推荐以下两种解决方案：

方案一：明确指定verbose_name

class Inline1(TabularInline):
    model = Model1
    tab = True
    verbose_name = 'model_1'  # 用于URL参数
    verbose_name_plural = '模型1'  # 用于标签页显示名称

class Inline2(TabularInline):
    model = Model2
    tab = True
    verbose_name = 'model_2'  # 用于URL参数
    verbose_name_plural = '模型2'  # 用于标签页显示名称

这种方法通过明确指定URL参数和显示名称，确保系统能够正确识别和区分不同的内联表单。

方案二：使用ASCII编码的verbose_name

如果模型名称必须包含非拉丁字符，可以将其转换为ASCII编码形式：

class Inline1(TabularInline):
    model = Model1
    tab = True
    verbose_name = 'model_1'
    verbose_name_plural = 'Model 1'  # 使用纯英文

class Inline2(TabularInline):
    model = Model2
    tab = True
    verbose_name = 'model_2'
    verbose_name_plural = 'Model 2'  # 使用纯英文

最佳实践建议

1. 保持一致性：建议所有内联表单都采用相同的命名规范，要么全部使用英文，要么全部使用本地语言但明确指定verbose_name。

2. 测试验证：在实现后，应测试以下功能：

   • 标签页切换是否正常
   • 每个标签页是否只显示对应的内联表单
   • 表单提交后数据是否保存到正确的模型中

3. 代码可读性：为verbose_name和verbose_name_plural添加注释，说明其用途，便于后续维护。

通过以上解决方案，开发者可以轻松解决Django-Unfold项目中多标签内联表单的显示问题，实现更加灵活和用户友好的管理界面。