Django model怎么自定義指定主鍵

# Django model怎么自定義指定主鍵

## 前言

在Django的ORM框架中，默認情況下每個模型(Model)都會自動生成一個名為`id`的自增主鍵字段。但在實際開發中，我們經常需要根據業務需求自定義主鍵字段。本文將詳細介紹如何在Django模型中自定義指定主鍵，包括使用已有字段作為主鍵、自定義主鍵類型以及相關注意事項。

---

## 一、默認主鍵行為

當不顯式指定主鍵時，Django會自動為模型添加以下字段：

```python
id = models.AutoField(primary_key=True)

這是一個自增的整數類型字段，從1開始遞增。這種設計在大多數情況下都能滿足需求，但在以下場景可能需要自定義主鍵：

1. 需要使用業務相關字段作為主鍵（如用戶手機號）
2. 需要使用非整數類型的主鍵（如UUID）
3. 需要與已有數據庫表結構兼容

二、自定義主鍵的三種方式

1. 使用已有字段作為主鍵

只需在某個字段參數中設置primary_key=True即可：

from django.db import models

class Student(models.Model):
    student_id = models.CharField(max_length=20, primary_key=True)
    name = models.CharField(max_length=100)
    
    def __str__(self):
        return self.name

注意點： - 設置primary_key=True后，Django不會再自動創建id字段 - 該字段將自動具有null=False和unique=True的約束 - 主鍵字段不可修改（除非先刪除再重新創建）

2. 使用UUID作為主鍵

適用于分布式系統或需要隱藏數據量的場景：

import uuid
from django.db import models

class Book(models.Model):
    id = models.UUIDField(
        primary_key=True,
        default=uuid.uuid4,
        editable=False
    )
    title = models.CharField(max_length=200)

優勢： - 全局唯一性 - 無需中央節點生成 - 隱藏數據規模信息

3. 使用復合主鍵

Django官方不直接支持復合主鍵，但可以通過兩種方式模擬：

方式一：使用unique_together約束

class OrderItem(models.Model):
    order = models.ForeignKey(Order, on_delete=models.CASCADE)
    product = models.ForeignKey(Product, on_delete=models.CASCADE)
    quantity = models.PositiveIntegerField()

    class Meta:
        unique_together = [['order', 'product']]

方式二：使用第三方包 如django-compositekey，但可能影響Django的兼容性

三、主鍵類型選擇指南

四、實際開發中的注意事項

1. 性能考慮：

   • 整數主鍵的索引效率通常高于字符串
   • UUID雖然避免了自增ID的缺點，但會導致索引碎片化

2. 遷移問題：

   # 修改主鍵類型需要謹慎處理遷移
   python manage.py makemigrations
   python manage.py migrate
   

3. Admin集成： 自定義主鍵后，admin界面可能需要額外配置：

   @admin.register(Book)
   class BookAdmin(admin.ModelAdmin):
      readonly_fields = ('id',)  # 防止修改主鍵
   

4. 序列化問題： UUID等非整數主鍵需要確保API序列化器正確處理：

   class BookSerializer(serializers.ModelSerializer):
      class Meta:
          model = Book
          fields = ['id', 'title']
   

五、總結

Django提供了靈活的主鍵自定義方案，開發者可以根據實際需求選擇： - 簡單應用保持默認AutoField即可 - 分布式系統推薦UUIDField - 業務實體可使用自然鍵作為主鍵 - 復合主鍵可通過unique_together模擬

合理的主鍵設計不僅能滿足業務需求，還能提升數據庫性能。建議在項目初期就明確主鍵策略，避免后期修改帶來的復雜遷移工作。

最佳實踐：除非有明確需求，否則建議優先使用默認自增ID，因其在簡單性、存儲效率和索引性能上都有優勢。 “`

這篇文章共計約900字，采用Markdown格式編寫，包含了代碼示例、表格對比和注意事項等實用內容，符合技術文檔的寫作規范。