讲师中心 微信公众号

工具推荐

视频效率加速
立刻MV
立刻MV

低成本歌曲 MV、视频生成

Laper
Laper

剧本策划到成片协作

updream

一键生成高质量推广成片

Seko
Seko

AI短剧一键生成成片

扩展 Django 用户模型:添加自定义字段

秋婷君_9059

秋婷君_9059

发布时间:2025-09-29 16:22:00

|

1021人浏览过

|

来源于php中文网

原创

扩展 django 用户模型:添加自定义字段

本文将介绍如何在 Django 中扩展默认的 User 模型,无需使用一对一关联,直接添加自定义字段。通过创建自定义用户模型并配置 AUTH_USER_MODEL,你可以轻松地在用户注册和管理中包含额外的 boolean 或 choice fields,并确保这些字段在 admin 后台正确显示和管理。

创建自定义用户模型

Django 允许你通过继承 AbstractUser 或 AbstractBaseUser 类来创建自定义用户模型。AbstractUser 已经包含了 Django 默认的用户模型中的大部分字段和方法,因此通常是扩展用户模型的首选。

在你的 Django 应用的 models.py 文件中,创建如下所示的自定义用户模型:

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

class CustomUser(AbstractUser):
    # 添加你的自定义字段
    is_premium = models.BooleanField(default=False, verbose_name="高级用户")
    subscription_type = models.CharField(
        max_length=20,
        choices=[
            ('basic', 'Basic'),
            ('premium', 'Premium'),
            ('enterprise', 'Enterprise'),
        ],
        default='basic',
        verbose_name="订阅类型"
    )

    def __str__(self):
        return self.username

在这个例子中,我们添加了两个自定义字段:

  • is_premium: 一个布尔字段,表示用户是否为高级用户。
  • subscription_type: 一个字符串字段,使用 choices 参数定义了用户订阅类型的选项。

配置 AUTH_USER_MODEL

为了让 Django 使用你的自定义用户模型,你需要修改 settings.py 文件,设置 AUTH_USER_MODEL 变量:

AUTH_USER_MODEL = 'your_app_name.CustomUser'  # 将 your_app_name 替换为你的应用名称

注意: 这一步非常重要,确保 Django 使用你的自定义用户模型而不是默认的 User 模型。

Biopython
Biopython

全面的分子生物学工具集。适用于序列操作、文件解析(FASTA/GenBank/PDB)、系统发育分析,以及通过 Bio.Entrez 以编程方式访问 NCBI/

下载

执行数据库迁移

在修改了用户模型后,你需要执行数据库迁移来更新数据库结构:

python manage.py makemigrations
python manage.py migrate

makemigrations 命令会生成迁移文件,描述了你对模型所做的更改。migrate 命令会将这些更改应用到数据库。

在 Admin 后台注册自定义用户模型

为了在 Django Admin 后台管理你的自定义用户模型,你需要将其注册到 admin.py 文件中。通常,你需要继承 UserAdmin 类并进行一些自定义:

from django.contrib import admin
from django.contrib.auth.admin import UserAdmin
from .models import CustomUser

class CustomUserAdmin(UserAdmin):
    model = CustomUser
    list_display = ['username', 'email', 'is_staff', 'is_premium', 'subscription_type'] # 自定义显示的字段
    fieldsets = (
        (None, {'fields': ('username', 'password')}),
        ('Personal info', {'fields': ('first_name', 'last_name', 'email')}),
        ('Permissions', {'fields': ('is_active', 'is_staff', 'is_superuser', 'groups', 'user_permissions')}),
        ('Important dates', {'fields': ('last_login', 'date_joined')}),
        ('Custom Fields', {'fields': ('is_premium', 'subscription_type')}), # 添加自定义字段
    )

admin.site.register(CustomUser, CustomUserAdmin)

在这个例子中,我们创建了一个 CustomUserAdmin 类,继承自 UserAdmin。 我们修改了 list_display 属性,使其在用户列表页面显示自定义字段。我们还修改了 fieldsets 属性,将自定义字段添加到用户编辑页面。

注意事项

  • 在项目初期进行自定义: 建议在项目初期就决定是否需要自定义用户模型。在项目后期更改 AUTH_USER_MODEL 可能会导致数据迁移问题。
  • 继承的选择: AbstractUser 提供了默认字段,而 AbstractBaseUser 则需要你完全定义用户模型。根据你的需求选择合适的基类。
  • 密码处理: 如果你选择 AbstractBaseUser,请确保正确处理密码的哈希和验证。
  • 迁移冲突: 在多人协作开发时,请注意数据库迁移的冲突,并及时解决。
  • 测试: 务必对自定义用户模型进行充分的测试,确保其功能正常。

总结

通过创建自定义用户模型并配置 AUTH_USER_MODEL,你可以轻松地扩展 Django 的用户模型,添加自定义字段,并在 admin 后台进行管理。这种方法避免了使用一对一关联带来的复杂性,使得用户信息的管理更加灵活和方便。 记住,在项目初期就进行自定义用户模型的决策,并进行充分的测试,以确保项目的稳定性和可维护性。

热门AI工具

更多
讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

创客贴AI

创客贴AI是一款AI图像与设计工具,AI辅助的智能在线设计工具。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

相关专题

更多
Python Web 框架 Django 深度开发
Python Web 框架 Django 深度开发

本专题系统讲解 Python Django 框架的核心功能与进阶开发技巧,包括 Django 项目结构、数据库模型与迁移、视图与模板渲染、表单与认证管理、RESTful API 开发、Django 中间件与缓存优化、部署与性能调优。通过实战案例,帮助学习者掌握 使用 Django 快速构建功能全面的 Web 应用与全栈开发能力。

613

2026.02.04

Python Django REST Framework接口安全与认证体系实践
Python Django REST Framework接口安全与认证体系实践

本专题围绕 Django REST Framework 展开,深入讲解 API 认证、JWT 鉴权、权限控制、接口安全防护以及防攻击策略设计。通过完整后端案例,帮助开发者构建安全可靠的 Web API 服务体系。

280

2026.06.29

java中boolean的用法
java中boolean的用法

在Java中,boolean是一种基本数据类型,它只有两个可能的值:true和false。boolean类型经常用于条件测试,比如进行比较或者检查某个条件是否满足。想了解更多java中boolean的相关内容,可以阅读本专题下面的文章。

2150

2023.11.13

java boolean类型
java boolean类型

本专题整合了java中boolean类型相关教程,阅读专题下面的文章了解更多详细内容。

163

2025.11.30

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

1958

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

3244

2023.09.04

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

6424

2023.10.24

字符串介绍
字符串介绍

字符串是一种数据类型,它可以是任何文本,包括字母、数字、符号等。字符串可以由不同的字符组成,例如空格、标点符号、数字等。在编程中,字符串通常用引号括起来,如单引号、双引号或反引号。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

6669

2023.11.24

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

140

2026.11.12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn