如何修改Django表单前缀与字段名的分隔符为下划线？

完全可行，Django默认用-作为前缀与字段名的分隔符，要改成_只需自定义表单的字段命名逻辑，以下是两种实用方法：

方法一：重写表单的add_prefix方法（全局生效） #

这是最直接的方案，通过自定义表单类覆盖默认的前缀拼接逻辑：

from django import forms

class CustomPrefixForm(forms.Form):
    # 示例字段，替换成你的实际字段
    username = forms.CharField(label="用户名")
    password = forms.CharField(label="密码", widget=forms.PasswordInput)

    def add_prefix(self, field_name):
        # 用下划线拼接前缀与字段名
        if self.prefix:
            return f"{self.prefix}_{field_name}"
        return field_name

使用时正常传递prefix参数即可：

# 实例化两个带不同前缀的表单
form1 = CustomPrefixForm(prefix="form_one")
form2 = CustomPrefixForm(prefix="form_two")

渲染后字段的id和name会变成form_one_username、form_two_password这类格式，完美避免重复且符合你的需求。

方法二：自定义Widget修改ID（局部字段生效） #

如果仅需针对部分字段调整分隔符，可以给字段绑定自定义Widget，重写ID生成逻辑：

from django import forms

class UnderlineIDWidget(forms.TextInput):
    def get_context(self, name, value, attrs):
        context = super().get_context(name, value, attrs)
        # 将ID中的'-'替换为'_'
        if 'id' in context['widget']['attrs']:
            context['widget']['attrs']['id'] = context['widget']['attrs']['id'].replace('-', '_')
        return context

# 在表单中使用自定义Widget
class MyForm(forms.Form):
    email = forms.EmailField(widget=UnderlineIDWidget())

注意事项 #

修改分隔符后无需额外调整后端表单处理逻辑，只要前端生成的字段name属性与add_prefix方法的输出一致，Django就能正常解析表单数据。

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