Django开发报错：module 'django.forms' 不存在 'PhoneNumberField' 属性

Hey there, I’ve run into this exact snag before—let’s get it sorted out quickly!

The core issue here is that Django’s built-in django.forms module doesn’t include a PhoneNumberField by default. You’ve got two solid paths to fix this: using a trusted third-party package, or rolling your own validation logic.

Option 1: Use the django-phonenumber-field Package (Recommended) #

This is the easiest and most robust route, since it handles phone number validation, formatting, and international support out of the box.

1. First, install the package and its dependency:

   pip install django-phonenumber-field phonenumbers
   

2. Add the app to your INSTALLED_APPS in settings.py:

   INSTALLED_APPS = [
       # ... your existing apps
       'phonenumber_field',
   ]
   

3. Update your form code to import the correct field:

   from django import forms
   from phonenumber_field.formfields import PhoneNumberField
   
   class ContactForm(forms.Form):
       name = forms.CharField(max_length=100)
       email = forms.EmailField()
       mobile = PhoneNumberField()  # This now works perfectly!
   

Option 2: Create Custom Validation (No Third-Party Packages) #

If you’d rather avoid adding external dependencies, you can use a regular CharField with a custom validator to check phone number validity.

First, install the phonenumbers library (used for parsing and validating numbers):

pip install phonenumbers

Then update your form code:

from django import forms
from django.core.exceptions import ValidationError
import phonenumbers

def validate_phone_number(value):
    try:
        # Parse the number (None allows international numbers without a country code)
        phonenumbers.parse(value, None)
    except phonenumbers.NumberParseException:
        raise ValidationError("Please enter a valid phone number (include a country code if needed).")

class ContactForm(forms.Form):
    name = forms.CharField(max_length=100)
    email = forms.EmailField()
    mobile = forms.CharField(max_length=20, validators=[validate_phone_number])

Either approach will resolve the error you’re seeing. The first option is better if you think you’ll need advanced features like automatic formatting or country-specific validation down the line.

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