在Django中使用自定義用戶模型是推薦做法，尤其是在項(xiàng)目初期；2. 通過繼承AbstractUser可擴(kuò)展字段並修改登錄方式，如將郵箱設(shè)為唯一登錄字段；3. 必須在settings.py中提前設(shè)置AUTH_USER_MODEL指向自定義模型，否則後續(xù)更改將導(dǎo)致外鍵斷裂；4. 創(chuàng)建遷移並運(yùn)行以生成數(shù)據(jù)庫(kù)表結(jié)構(gòu)；5. 可自定義admin類以在後臺(tái)顯示新增字段；6. 創(chuàng)建超級(jí)用戶驗(yàn)證配置是否生效；7. 可通過自定義表單處理註冊(cè)邏輯；8. AbstractUser適用於擴(kuò)展字段場(chǎng)景，AbstractBaseUser用於完全自定義認(rèn)證；9. 若需隱藏username，可在表單或save方法中自動(dòng)生成。完整流程涵蓋模型定義、配置、遷移、後臺(tái)管理與表單適配，且必須在項(xiàng)目初期完成用戶模型設(shè)置，以避免數(shù)據(jù)依賴問題。

在Django 中使用自定義用戶模型（Custom User Model）是推薦做法，尤其是在項(xiàng)目初期。它提供了更大的靈活性，比如擴(kuò)展字段（如手機(jī)號(hào)、暱稱）、修改認(rèn)證方式（如用郵箱登錄代替用戶名），以及更好地適應(yīng)未來需求。

下面是一個(gè)完整的Django 自定義用戶模型示例，使用AbstractUser擴(kuò)展，並將郵箱設(shè)為唯一登錄字段。

? 1. 創(chuàng)建自定義用戶模型

假設(shè)你的項(xiàng)目名為myproject ，應(yīng)用名為users 。

先創(chuàng)建應(yīng)用（如果還沒有）：

 python manage.py startapp users

然後在users/models.py中定義自定義用戶模型：

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

class CustomUser(AbstractUser):
    email = models.EmailField(unique=True) # 郵箱唯一phone = models.CharField(max_length=15, blank=True, null=True)
    nickname = models.CharField(max_length=50, blank=True, null=True)

    USERNAME_FIELD = 'email' # 使用郵箱登錄REQUIRED_FIELDS = ['username', 'first_name', 'last_name'] # 超級(jí)用戶需要填寫的字段def __str__(self):
        return self.email

? 注意：

• 繼承AbstractUser可以保留原有功能，同時(shí)擴(kuò)展字段。
• USERNAME_FIELD設(shè)置為email ，意味著用戶通過郵箱登錄。
• REQUIRED_FIELDS是創(chuàng)建超級(jí)用戶時(shí)必須輸入的字段（除了密碼）。

? 2. 更新settings.py

在myproject/settings.py中告訴Django 使用你的新用戶模型：

 # myproject/settings.py

# 修改默認(rèn)用戶模型AUTH_USER_MODEL = 'users.CustomUser'

# 其他設(shè)置...
INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'users', # 註冊(cè)u(píng)sers 應(yīng)用]

?? 注意：這一步必須在第一次遷移前完成！否則後續(xù)修改會(huì)非常麻煩。

? 3. 創(chuàng)建並運(yùn)行遷移

python manage.py makemigrations users
python manage.py migrate

這會(huì)創(chuàng)建包含你自定義用戶表的數(shù)據(jù)庫(kù)結(jié)構(gòu)。

? 4. 自定義管理後臺(tái)（可選）

為了讓自定義字段在Django admin 中正常顯示，修改users/admin.py ：

 # users/admin.py
from django.contrib import admin
from django.contrib.auth.admin import UserAdmin
from .models import CustomUser

class CustomUserAdmin(UserAdmin):
    model = CustomUser
    list_display = ['email', 'username', 'first_name', 'last_name', 'is_staff']
    fieldsets = UserAdmin.fieldsets (
        (None, {'fields': ('phone', 'nickname')}),
    )
    add_fieldsets = UserAdmin.add_fieldsets (
        (None, {'fields': ('phone', 'nickname')}),
    )

admin.site.register(CustomUser, CustomUserAdmin)

? 5. 創(chuàng)建超級(jí)用戶測(cè)試

運(yùn)行命令創(chuàng)建超級(jí)用戶：

 python manage.py createsuperuser

輸入郵箱、用戶名、密碼等信息，登錄http://ipnx.cn/link/d5a44bdaee01bac1c4490d1aded4c0d8查看是否生效。

? 6. 在表單中使用（可選）

你可以自定義註冊(cè)表單來適配新模型：

 # users/forms.py
from django import forms
from django.contrib.auth.forms import UserCreationForm
from .models import CustomUser

class CustomUserCreationForm(UserCreationForm):
    class Meta:
        model = CustomUser
        fields = ('username', 'email', 'first_name', 'last_name', 'password1', 'password2', 'phone', 'nickname')

然後在視圖中使用這個(gè)表單處理註冊(cè)邏輯。

? 常見問題說明

• 為什麼不能中途換用戶模型？
  因?yàn)镈jango 的外鍵依賴（如auth、sessions、log entry）都指向auth.User ，中途更換會(huì)導(dǎo)致外鍵斷裂。所以一定要在項(xiàng)目初期設(shè)置。

• AbstractUser vs AbstractBaseUser？

  • AbstractUser ：適合只需要擴(kuò)展字段或改登錄字段的場(chǎng)景（推薦大多數(shù)情況使用）。
  • AbstractBaseUser ：完全自定義認(rèn)證邏輯（如只用手機(jī)號(hào)、無密碼登錄等），更複雜。

• 如何用郵箱登錄而不讓用戶填username？
  可以在表單中自動(dòng)生成username（比如用郵箱前綴），或者覆蓋save()方法。

基本上就這些。這個(gè)例子覆蓋了從模型定義到後臺(tái)管理的完整流程，適合大多數(shù)項(xiàng)目需求。不復(fù)雜但容易忽略細(xì)節(jié)，尤其是AUTH_USER_MODEL必須儘早設(shè)置。

以上是Python Django自定義用戶模型示例的詳細(xì)內(nèi)容。更多資訊請(qǐng)關(guān)注PHP中文網(wǎng)其他相關(guān)文章！