如何在Django REST Framework中为列表页和详情页展示不同模型字段？

方案一：创建两个独立序列化器（简单直观） #

适合字段差异固定的场景，逻辑清晰易维护：

修改 serializers.py #

from rest_framework import serializers
from .models import Task

# 列表页专用序列化器
class TaskListSerializer(serializers.ModelSerializer):
    class Meta:
        model = Task
        fields = ("id", "title", "deadline", "done")

# 详情页专用序列化器
class TaskDetailSerializer(serializers.ModelSerializer):
    class Meta:
        model = Task
        fields = ("id", "title", "body", "author", "deadline", "done")

修改 views.py #

为不同视图绑定对应序列化器：

from rest_framework import generics
from .models import Task
from .serializers import TaskListSerializer, TaskDetailSerializer

class TaskList(generics.ListCreateAPIView):
    queryset = Task.objects.all()
    serializer_class = TaskListSerializer

class TaskDetail(generics.RetrieveUpdateDestroyAPIView):
    queryset = Task.objects.all()
    serializer_class = TaskDetailSerializer

方案二：动态修改序列化器字段（复用单个序列化器） #

利用DRF的动态字段能力，在单个序列化器中根据场景调整返回字段，适合需要灵活控制字段的场景：

修改 serializers.py #

from rest_framework import serializers
from .models import Task

class TaskSerializer(serializers.ModelSerializer):
    class Meta:
        model = Task
        fields = ("id", "title", "body", "author", "deadline", "done")

    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        # 通过请求路径判断是否为列表页场景
        request = self.context.get('request')
        if request and request.method == 'GET' and 'pk' not in request.path:
            # 保留列表页需要的字段，移除其余字段
            allowed_fields = {"id", "title", "deadline", "done"}
            for field in set(self.fields.keys()) - allowed_fields:
                self.fields.pop(field)

也可通过视图传递标识的方式（更严谨）：

# serializers.py
class TaskSerializer(serializers.ModelSerializer):
    class Meta:
        model = Task
        fields = ("id", "title", "body", "author", "deadline", "done")

    def __init__(self, *args, **kwargs):
        self.is_list = kwargs.pop('is_list', False)
        super().__init__(*args, **kwargs)
        if self.is_list:
            allowed_fields = {"id", "title", "deadline", "done"}
            for field in set(self.fields.keys()) - allowed_fields:
                self.fields.pop(field)

# views.py
class TaskList(generics.ListCreateAPIView):
    queryset = Task.objects.all()
    
    def get_serializer(self, *args, **kwargs):
        kwargs['is_list'] = True
        return super().get_serializer(*args, **kwargs)

class TaskDetail(generics.RetrieveUpdateDestroyAPIView):
    queryset = Task.objects.all()

参考资料 #

Django REST Framework 序列化器动态修改字段官方文档

内容的提问来源于stack exchange，提问作者Ulan