Python中Django如何实现扩展user模块

在Django里扩展User模型，主要有三种主流方法，看你具体需求。

1. 使用Profile模型（一对一关联） 这是最常用、侵入性最小的方法。保持Django自带的auth_user表不变，新建一个Profile模型通过OneToOneField关联它。适合添加头像、电话等额外信息。

from django.contrib.auth.models import User
from django.db import models

class UserProfile(models.Model):
    user = models.OneToOneField(User, on_delete=models.CASCADE, related_name='profile')
    phone = models.CharField(max_length=20, blank=True)
    avatar = models.ImageField(upload_to='avatars/', blank=True)

# 创建信号，在User创建时自动创建Profile
from django.db.models.signals import post_save
from django.dispatch import receiver

@receiver(post_save, sender=User)
def create_user_profile(sender, instance, created, **kwargs):
    if created:
        UserProfile.objects.create(user=instance)

使用时通过user.profile.phone访问扩展字段。

2. 继承AbstractUser（替换整个User） 如果你需要完全替换Django的User模型，比如要改用户名字段为邮箱，或者添加大量新字段，就继承AbstractUser。这需要一开始就设置好。

# models.py
from django.contrib.auth.models import AbstractUser
from django.db import models

class CustomUser(AbstractUser):
    # 添加新字段
    phone = models.CharField(max_length=20, blank=True)
    # 可以修改原有字段，比如使email唯一且非空
    email = models.EmailField(unique=True, blank=False)

    def __str__(self):
        return self.username

# settings.py 中必须配置
AUTH_USER_MODEL = 'your_app.CustomUser'

之后所有对User的引用都要改成get_user_model()或settings.AUTH_USER_MODEL。

3. 继承AbstractBaseUser（完全自定义） 当Django默认的User字段（如username、first_name）你大部分都不需要，想从头设计认证核心（比如只用邮箱或手机号登录）时用这个。最灵活，但也最复杂。

from django.contrib.auth.models import AbstractBaseUser, BaseUserManager, PermissionsMixin

class CustomUserManager(BaseUserManager):
    def create_user(self, email, password=None, **extra_fields):
        # 完全自定义创建用户的逻辑
        pass
    def create_superuser(self, email, password=None, **extra_fields):
        # 自定义创建超级用户的逻辑
        pass

class CustomUser(AbstractBaseUser, PermissionsMixin):
    email = models.EmailField(unique=True)
    is_active = models.BooleanField(default=True)
    # ... 你的其他字段
    objects = CustomUserManager()
    USERNAME_FIELD = 'email' # 指定用email作为唯一标识
    REQUIRED_FIELDS = [] # 创建超级用户时需要提示的字段

    # settings.py 同样需要配置 AUTH_USER_MODEL

总结建议： 大多数情况用Profile模型或继承AbstractUser就足够了。