DRF ModelSerializer重命名字段且保留模型字段定义的方法

这个问题我之前也遇到过，确实直接用source一个个定义字段太繁琐，还容易丢失模型里的原有属性（比如你遇到的editable=True问题，就是因为显式定义字段时默认覆盖了模型的editable=False设置）。其实咱们可以通过以下几种方式实现批量重命名，同时完整保留模型字段的原始定义：

方法一：重写get_fields方法（推荐批量场景） #

这是最灵活的方案，既能批量处理字段重命名，又能完全继承模型字段的所有属性（包括editable、字段类型、验证规则等），完美保留ModelSerializer的自动生成优势。

示例代码 #

from rest_framework import serializers
from your_app.models import YourProductModel

class ProductSerializer(serializers.ModelSerializer):
    def get_fields(self):
        # 先获取ModelSerializer自动生成的所有字段（包含模型的所有属性）
        original_fields = super().get_fields()
        
        # 定义字段重命名映射：key是模型字段名，value是API要显示的字段名
        rename_mapping = {
            'product_uid': 'uid',
            # 可以添加更多批量重命名规则，比如 'product_name': 'name' 等
        }
        
        # 构建新的字段字典
        renamed_fields = {}
        for old_field_name, field_instance in original_fields.items():
            # 替换字段名，没有映射的保持原名
            new_field_name = rename_mapping.get(old_field_name, old_field_name)
            # 直接复用原字段实例，完全保留模型的属性设置
            renamed_fields[new_field_name] = field_instance
        
        return renamed_fields

    class Meta:
        model = YourProductModel
        # 这里要写重命名后的字段名，或者用 '__all__' （如果所有需要重命名的都在映射里）
        fields = ['uid', 'other_field1', 'other_field2']

为什么这个方法有效？ #

• 调用super().get_fields()会自动根据模型生成包含所有原始属性的字段实例，比如你的product_uid对应的字段会自带editable=False属性；
• 我们只是修改了字段的键名（也就是API返回的字段名），字段实例本身完全复用，所以所有模型里的设置都会被保留。

如果你的命名转换有固定规律（比如下划线转驼峰），还可以把映射改成自动生成的，比如：

import re

def snake_to_camel(snake_str):
    components = snake_str.split('_')
    return components[0] + ''.join(x.title() for x in components[1:])

# 在get_fields里替换映射部分：
for old_field_name, field_instance in original_fields.items():
    new_field_name = snake_to_camel(old_field_name)
    renamed_fields[new_field_name] = field_instance

方法二：单个字段快速处理（适合少量字段） #

如果只是少数几个字段需要重命名，可以显式定义字段，但手动继承模型的属性：

class ProductSerializer(serializers.ModelSerializer):
    # 直接从模型字段获取editable属性，或者手动指定
    uid = serializers.UUIDField(
        source='product_uid',
        editable=YourProductModel._meta.get_field('product_uid').editable
    )

    class Meta:
        model = YourProductModel
        fields = ['uid', ...]

不过这种方法在批量场景下效率低，不如第一种方法灵活。

补充说明 #

你提到的serializers.ModelField其实并不适合这个场景，它主要用于处理模型中自定义的非标准字段，而且需要手动指定很多属性，反而不如上面的方案方便。

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