Django开发：自定义User模型与一对一User Profile模型的最佳实践抉择

一、两种方案的核心区别 #

1. 自定义User模型 #

直接继承AbstractUser（推荐，保留原生认证字段）或AbstractBaseUser（完全自定义认证逻辑），把业务相关的基础扩展字段整合到同一个模型中。

• 优势：
  • 查询用户数据无需跨表，性能更优；操作逻辑直接，不用额外处理关联关系
  • 和Django原生认证系统无缝兼容，登录、权限等模块无需改动
  • 后期新增字段更省心，不用维护额外的关联模型
• 劣势：
  • 项目中途切换自定义User模型成本极高，涉及数据库迁移和代码重构，必须在项目初期就确定
  • 若塞入过多字段，会导致User模型臃肿，职责边界模糊

2. 一对一Profile模型 #

保留Django默认的User模型，新建Profile模型通过OneToOneField与User关联，将业务扩展字段放在Profile中。

• 优势：
  • 职责分离：User专注处理认证核心（用户名、密码、邮箱），Profile负责业务详情（昵称、头像等）
  • 项目任意阶段都能添加，无需改动原有User模型结构
  • 调整Profile字段不会影响认证系统，风险更低
• 劣势：
  • 查询用户完整信息需要跨表关联，高频查询会有性能损耗
  • 用户创建、编辑操作需同时处理两个模型，代码多一层关联逻辑

二、结合你的需求的方案建议 #

你提到的followers、following是用户间的多对多关系，likes是用户与内容的多对多关系，connections大概率也是用户关联——这些字段完全不适合直接塞进User或Profile，应该单独建模型处理（比如UserFollow、UserLike），避免核心模型过于臃肿。

针对User模型本身的选择：

• 如果是新项目刚启动：优先选自定义User模型
  • 将用户需要编辑的基础详情（如昵称、头像）放在Custom User中
  • 用单独模型处理关注、点赞这类关联关系
  • 编辑用户详情时，直接基于Custom User生成表单，提交后保存即可，逻辑极简
• 如果是已运行一段时间的老项目：选一对一Profile模型
  • 把可编辑的详情字段放在Profile里，无需改动原有User模型
  • 同样用单独模型处理关注、点赞关系
  • 编辑详情时操作Profile模型即可，记得用post_save信号为新用户自动生成Profile，避免关联缺失

三、实用代码示例 #

自定义User模型+关注关系 #

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

class CustomUser(AbstractUser):
    # 可编辑的基础扩展字段
    nickname = models.CharField(max_length=50, blank=True, verbose_name='昵称')
    avatar = models.ImageField(upload_to='user_avatars/', blank=True, verbose_name='头像')

# 关注关系模型
class UserFollow(models.Model):
    follower = models.ForeignKey(CustomUser, on_delete=models.CASCADE, related_name='following')
    following = models.ForeignKey(CustomUser, on_delete=models.CASCADE, related_name='followers')
    created_at = models.DateTimeField(auto_now_add=True)

    class Meta:
        # 避免重复关注同一用户
        unique_together = ('follower', 'following')

一对一Profile模型+自动生成 #

from django.contrib.auth.models import User
from django.db import models
from django.db.models.signals import post_save
from django.dispatch import receiver

class Profile(models.Model):
    user = models.OneToOneField(User, on_delete=models.CASCADE)
    nickname = models.CharField(max_length=50, blank=True, verbose_name='昵称')
    avatar = models.ImageField(upload_to='user_avatars/', blank=True, verbose_name='头像')

# 新用户创建时自动生成对应Profile
@receiver(post_save, sender=User)
def create_profile(sender, instance, created, **kwargs):
    if created:
        Profile.objects.create(user=instance)

@receiver(post_save, sender=User)
def save_profile(sender, instance, **kwargs):
    instance.profile.save()

# 关注关系模型和上面类似，将CustomUser替换为User即可

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