Python Django自定義用戶模型示例

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

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

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

✅ 1. 創建自定義用戶模型

假設你的項目名為myproject ，應用名為users 。

先創建應用（如果還沒有）：

 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'] # 超級用戶需要填寫的字段def __str__(self):
        return self.email

? 注意：

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

✅ 2. 更新settings.py

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

 # myproject/settings.py

# 修改默認用戶模型AUTH_USER_MODEL = 'users.CustomUser'

# 其他設置...
INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'users', # 註冊users 應用]

⚠️ 注意：這一步必須在第一次遷移前完成！否則後續修改會非常麻煩。

✅ 3. 創建並運行遷移

python manage.py makemigrations users
python manage.py migrate

這會創建包含你自定義用戶表的數據庫結構。

✅ 4. 自定義管理後台（可選）

為了讓自定義字段在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. 創建超級用戶測試

運行命令創建超級用戶：

 python manage.py createsuperuser

輸入郵箱、用戶名、密碼等信息，登錄//m.sbmmt.com/link/d5a44bdaee01bac1c4490d1aded4c0d8查看是否生效。

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

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

 # 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')

然後在視圖中使用這個表單處理註冊邏輯。

✅ 常見問題說明

• 為什麼不能中途換用戶模型？
  因為Django 的外鍵依賴（如auth、sessions、log entry）都指向auth.User ，中途更換會導致外鍵斷裂。所以一定要在項目初期設置。

• AbstractUser vs AbstractBaseUser？

  • AbstractUser ：適合只需要擴展字段或改登錄字段的場景（推薦大多數情況使用）。
  • AbstractBaseUser ：完全自定義認證邏輯（如只用手機號、無密碼登錄等），更複雜。

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

基本上就這些。這個例子覆蓋了從模型定義到後台管理的完整流程，適合大多數項目需求。不復雜但容易忽略細節，尤其是AUTH_USER_MODEL必須儘早設置。

以上是Python Django自定義用戶模型示例的詳細內容。更多資訊請關注PHP中文網其他相關文章！