Django REST Framework 中的序列化器是什么？

Question

Accepted Answer

**Django REST Framework (DRF)** 是用 Django 构建 REST API 的实际标准，**序列化器（serializers）** 是其核心概念。序列化器将复杂数据（模型实例、querysets）**转换为** JSON 以用于 API 响应，并将传入的 JSON **转换回** 经过验证的 Python 对象——既处理序列化，也处理验证，就像表单对 HTML 的作用一样。

## ModelSerializer — 常见情况

```python
from rest_framework import serializers
from .models import Article

class ArticleSerializer(serializers.ModelSerializer):
    class Meta:
        model = Article                              # build from a model (DRY)
        fields = ["id", "title", "body", "published", "created_at"]
        read_only_fields = ["id", "created_at"]
```

`ModelSerializer` 从模型中自动生成字段（如 ModelForm）——用最少的代码对模型进行序列化和验证。

## 序列化：对象 → JSON

```python
article = Article.objects.get(pk=1)
serializer = ArticleSerializer(article)
serializer.data        # {"id": 1, "title": "Hello", "body": "...", ...} → return as JSON

# serialize a queryset (many objects)
serializer = ArticleSerializer(Article.objects.all(), many=True)
serializer.data        # a list of dicts
```

## 反序列化 + 验证：JSON → 验证的对象

```python
serializer = ArticleSerializer(data=request.data)   # incoming JSON
if serializer.is_valid():                            # VALIDATE (like a form)
    article = serializer.save()                       # create/update the model
else:
    return Response(serializer.errors, status=400)   # validation error details
```

这个模式类似于表单：`is_valid()` 根据字段规则和模型验证传入的数据，`save()` 将其持久化。无效数据会产生结构化的错误消息。

## 自定义验证和字段

```python
class ArticleSerializer(serializers.ModelSerializer):
    word_count = serializers.SerializerMethodField()   # a computed, read-only field

def get_word_count(self, obj):
        return len(obj.body.split())

def validate_title(self, value):                    # field-level validation
        if "spam" in value.lower():
            raise serializers.ValidationError("No spam")
        return value
```

## 嵌套序列化器（相关数据）

```python
class AuthorSerializer(serializers.ModelSerializer):
    class Meta: model = Author; fields = ["name"]

class ArticleSerializer(serializers.ModelSerializer):
    author = AuthorSerializer(read_only=True)          # embed related author data
    class Meta: model = Article; fields = ["title", "author"]
```

序列化器可以**嵌套**来表示相关对象（在文章的 JSON 中嵌入作者的数据）——你可以独立于数据库模式来控制 API 的形状。

## 为什么这很重要

序列化器是使用 Django REST Framework 构建 REST API 的基础，而 DRF 是 Django API 的标准工具——因此理解序列化器对于任何为前端、移动应用或其他服务提供 JSON 的现代 Django 后端开发者来说都是必不可少的。

序列化器解决了 API 的两个基本需求：将 Python/模型数据**转换为 JSON** 用于响应（序列化），以及将传入的**JSON 转换为经过验证的 Python 对象**用于创建/更新数据（反序列化 + 验证）。

验证方面对于**安全性和稳健性**至关重要——就像 HTML 表单一样，序列化器确保你永远不会信任原始 API 输入，在它到达你的数据库之前根据字段规则验证它。**ModelSerializer** 通过从模型自动生成字段（DRY，如 ModelForm）提供了重大的生产力提升，使得将模型公开为 API 资源变得轻而易举，同时 `is_valid()`/`save()` 模式可以干净地处理完整的创建/更新生命周期。

理解如何序列化对象和 querysets、反序列化和验证输入、添加自定义验证和计算字段，以及使用**嵌套序列化器**处理相关数据（独立于数据库模式控制 API 的形状）是构建 API 的基础。

序列化器是 DRF 处理数据转换和验证等核心 API 关切的地方，使其成为中心的、必知的知识——其重要性类似于传统 Django 中的表单，但针对当代 Web 开发中占主导地位的 API 驱动应用程序。