Django 表单中如何自定义错误消息？

推荐答案

在 Django 表单中，可以通过以下方式自定义错误消息：

1. 在表单字段中定义 error_messages 参数：

   // www.javascriptcn.com code example
   from django import forms
   
   class MyForm(forms.Form):
       username = forms.CharField(
           max_length=30,
           error_messages={
               'required': '用户名不能为空',
               'max_length': '用户名长度不能超过30个字符',
           }
       )

2. 在表单的 clean 方法中自定义错误消息：

   class MyForm(forms.Form):
       username = forms.CharField(max_length=30)
   
       def clean_username(self):
           username = self.cleaned_data.get('username')
           if username == 'admin':
               raise forms.ValidationError('用户名不能为 admin')
           return username

3. 在表单的 clean 方法中自定义非字段错误消息：

   // www.javascriptcn.com code example
   class MyForm(forms.Form):
       username = forms.CharField(max_length=30)
       password = forms.CharField(widget=forms.PasswordInput)
   
       def clean(self):
           cleaned_data = super().clean()
           username = cleaned_data.get('username')
           password = cleaned_data.get('password')
   
           if username == 'admin' and password == 'admin':
               raise forms.ValidationError('用户名和密码不能都为 admin')

本题详细解读

1. 使用 error_messages 参数

Django 表单字段的 error_messages 参数允许你为特定的验证错误提供自定义的错误消息。你可以通过传递一个字典来覆盖默认的错误消息。字典的键是错误类型（如 required、max_length 等），值是你想要显示的错误消息。

2. 在 clean_<fieldname> 方法中自定义错误消息

Django 允许你为每个字段定义一个 clean_<fieldname> 方法，用于对该字段进行自定义验证。在这个方法中，你可以检查字段的值，并在不符合条件时抛出 forms.ValidationError 异常，并附带自定义的错误消息。

3. 在 clean 方法中自定义非字段错误消息

clean 方法用于对整个表单进行验证。你可以在这个方法中检查多个字段之间的关系，并在不符合条件时抛出 forms.ValidationError 异常。这种情况下，错误消息将与特定字段无关，而是与整个表单相关。

4. 错误消息的显示

自定义的错误消息会在表单验证失败时自动显示在表单的错误列表中。你可以通过 form.errors 或 form.<fieldname>.errors 来访问这些错误消息，并在模板中渲染它们。

5. 默认错误消息

如果你没有自定义错误消息，Django 会使用默认的错误消息。你可以通过 django/forms/fields.py 中的 default_error_messages 属性查看这些默认消息。

通过以上方法，你可以灵活地控制 Django 表单中的错误消息，使其更符合你的应用需求。