Django模型自定义属性在QuerySet及转字典时不显示的解决方法

1. 让打印对象时显示自定义属性 #

Django模型默认的__str__方法仅输出数据库字段，要让flag_from在打印时可见，直接重写__str__方法即可：

class Offers(models.Model):      
    @property
    def flag_from(self):
        return self.country.country_flag
    
    status  = models.BooleanField()
    country = models.ForeignKey('Country',  db_index=True, on_delete=models.PROTECT)
    # ...其他字段

    def __str__(self):
        # 自定义输出格式，包含需要的字段和属性
        return f"Offers(id={self.pk}, status={self.status}, flag_from={self.flag_from})"

修改后打印line就能看到flag_from的内容。

2. 转换为字典时保留自定义属性 #

Django自带的model_to_dict或直接调用__dict__只会处理数据库字段，要包含flag_from这类动态属性，有三种常用方案：

方法一：自定义转字典方法 #

在Offers模型中添加自定义方法，手动整合字段和属性：

class Offers(models.Model):      
    # ...现有代码

    def to_dict(self):
        # 先获取所有数据库字段的键值对
        data = {field.name: getattr(self, field.name) for field in self._meta.fields}
        # 添加自定义属性
        data['flag_from'] = self.flag_from
        # 其他自定义属性也可在此添加
        return data

使用时直接调用：

line = Offers.objects.get(pk=1)
line_dict = line.to_dict()

方法二：扩展model_to_dict #

如果习惯用model_to_dict，可以手动追加属性：

from django.forms.models import model_to_dict

line = Offers.objects.get(pk=1)
line_dict = model_to_dict(line)
line_dict['flag_from'] = line.flag_from

方法三：用DRF序列化器（项目已用DRF时） #

若项目使用Django REST Framework，可通过序列化器直接包含自定义属性：

from rest_framework import serializers

class OffersSerializer(serializers.ModelSerializer):
    flag_from = serializers.CharField(read_only=True)

    class Meta:
        model = Offers
        fields = ['id', 'status', 'country', 'flag_from']  # 列出需要的字段和属性

使用示例：

serializer = OffersSerializer(line)
line_dict = serializer.data

补充优化 #

每次访问flag_from会触发关联的Country查询，可在查询Offers时用select_related提前预加载，避免N+1查询问题：

line = Offers.objects.select_related('country').get(pk=1)

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