如何在 ORM 中建模关系？

Question

如何在 ORM 中建模关系？

Accepted Answer

Django 的 ORM 用专门的字段类型来建模三种基本的数据库关系：**ForeignKey**（一对多）、**ManyToManyField**（多对多）和 **OneToOneField**（一对一）。它们定义了表之间如何关联，并让你能够以 Pythonic 的方式访问关联对象。

## ForeignKey — 一对多（最常见）

```python
class Author(models.Model):
    name = models.CharField(max_length=100)

class Book(models.Model):
    title = models.CharField(max_length=200)
    author = models.ForeignKey(
        Author,
        on_delete=models.CASCADE,        # what happens if the author is deleted
        related_name="books",            # access the reverse: author.books
    )
```

```python
# access related objects naturally:
book.author                # the Author this book belongs to (forward)
author.books.all()         # all Books by this author (reverse, via related_name)
```

`ForeignKey` 建模的是"多本书属于同一个作者"。`on_delete` 行为（`CASCADE`、`PROTECT`、`SET_NULL` 等）是**必需的**，它定义了当作者被删除时这些书会发生什么。

## ManyToManyField — 多对多

```python
class Article(models.Model):
    title = models.CharField(max_length=200)
    tags = models.ManyToManyField("Tag", related_name="articles")   # many tags ↔ many articles

class Tag(models.Model):
    name = models.CharField(max_length=50)
```

```python
article.tags.add(tag1, tag2)        # associate tags
article.tags.all()                   # all tags on this article
tag.articles.all()                   # all articles with this tag (reverse)
```

Django 会在 `ManyToManyField` 背后自动创建**连接表**（join table）——你只需使用 `.add()`、`.remove()`、`.all()`。（如果关系上需要额外的数据，可以使用 `through` 模型。）

## OneToOneField — 一对一

```python
class User(models.Model):
    username = models.CharField(max_length=50)

class Profile(models.Model):
    user = models.OneToOneField(User, on_delete=models.CASCADE)   # one profile per user
    bio = models.TextField()
```

`OneToOneField` 强制建立严格的一对一关联——通常用于扩展某个模型（例如用 Profile 扩展 User）。

## on_delete 选项（正确选择很重要）

```text
CASCADE   → delete related objects too (delete author → delete their books)
PROTECT   → prevent deletion if related objects exist (raises an error)
SET_NULL  → set the FK to NULL (requires null=True) — keep the books, orphan them
SET_DEFAULT / SET(...) → set to a default/computed value
RESTRICT  → similar to PROTECT, with nuances
```

## 跨关系查询

```python
# traverse relationships in queries with __ (double underscore)
Book.objects.filter(author__name="Tolkien")        # books whose author's name is Tolkien
Article.objects.filter(tags__name="python")         # articles tagged 'python'
```

## 为什么这很重要

正确地建模关系是在 Django 中处理关系型数据的基础——几乎每个真实的应用程序都有相互关联的实体（用户和帖子、订单和商品、文章和标签），因此理解这三种关系字段类型是必备的日常知识。

知道何时使用每一种——**ForeignKey** 用于一对多（最常见，比如书属于某个作者）、**ManyToManyField** 用于多对多（比如文章和标签，Django 会自动管理连接表）、**OneToOneField** 用于一对一（比如用 Profile 扩展用户）——对于设计任何非平凡的数据模型都是必要的。

ORM 让关联数据变得 **Pythonic 且便捷**（可以自然地访问 `book.author` 和 `author.books.all()`，并用 `__` 跨关系查询），但有两点需要谨慎：选择正确的 **`on_delete` 行为**（这是一个必需且影响重大的决定——`CASCADE` 会删除关联对象，`PROTECT` 会阻止删除，`SET_NULL` 会让它们成为孤儿记录——选错可能导致意外的数据丢失或完整性错误），以及使用 `related_name` 来获得清晰的反向访问。

理解关系建模、on_delete 选项和跨关系查询，是构建正确、设计良好的 Django 数据模型的核心，而且它直接关联到查询优化（因为简单粗暴地遍历关系会导致 N+1 问题），这使它既是基础知识，也是常被考查的知识。