如何通过嵌套序列化器让Milestone的description仅在ProjectDetailSerializer中显示

你尝试的+ ['milestones.description']之所以无效，是因为DRF父序列化器的fields配置只能控制是否包含整个嵌套字段，无法直接修改嵌套子序列化器的内部字段。下面是两种可靠的实现方式：

方法1：创建不同粒度的Milestone序列化器 #

这是最清晰、易维护的方案——为不同场景分别定义Milestone序列化器：

# 基础版Milestone序列化器（不含description）
class MilestoneSerializer(serializers.ModelSerializer):
    class Meta:
        model = Milestone
        fields = ['id', 'name', 'due_date']  # 根据你的需求调整其他已有字段

# 详情版Milestone序列化器（继承基础版并添加description）
class MilestoneDetailSerializer(MilestoneSerializer):
    class Meta(MilestoneSerializer.Meta):
        fields = MilestoneSerializer.Meta.fields + ['description']

# 基础Project序列化器（用基础版Milestone序列化器）
class ProjectSerializer(serializers.ModelSerializer):
    milestones = MilestoneSerializer(many=True, read_only=True)

    class Meta:
        model = Project
        fields = ['id', 'name', 'milestones']

# 详情版Project序列化器（重写milestones字段，用详情版Milestone序列化器）
class ProjectDetailSerializer(ProjectSerializer):
    milestones = MilestoneDetailSerializer(many=True, read_only=True)

方法2：动态修改子序列化器字段（适合不想多建类的场景） #

如果不想额外创建MilestoneDetailSerializer，可以在ProjectDetailSerializer的get_fields方法里动态修改嵌套序列化器的字段：

class ProjectDetailSerializer(ProjectSerializer):
    def get_fields(self):
        # 先获取父类定义的所有字段
        fields = super().get_fields()
        # 取出嵌套的milestones字段对应的子序列化器
        milestone_child_serializer = fields['milestones'].child
        # 给子序列化器的字段列表添加description
        milestone_child_serializer.Meta.fields = list(milestone_child_serializer.Meta.fields) + ['description']
        return fields

关于你的疑问 #

不需要先在MilestoneSerializer中添加description再在ProjectSerializer中移除。上面两种方案都能精准控制仅在ProjectDetailSerializer中让嵌套的Milestone展示description字段，逻辑更清晰，也避免了不必要的字段隐藏操作。

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