如何全局自定义Django自定义字段Percentage的模板显示格式？

要实现全局自动带%符号的格式渲染，核心是用自定义模型字段包装数值，让取出的数据库值成为一个带格式化逻辑的对象，这样模板和Admin无需额外处理就能直接显示正确格式。以下是具体实现步骤：

1. 定义数值包装类 #

创建一个PercentageValue类，重写__str__方法实现格式化逻辑：

class PercentageValue:
    def __init__(self, value):
        self.value = value

    def __str__(self):
        # 根据需求格式化：整数显示为"100%"，小数保留两位如"50.50%"（可按需调整）
        if self.value.is_integer():
            return f"{int(self.value)}%"
        return f"{self.value:.2f}%"

2. 自定义模型字段 #

继承FloatField，重写关键方法实现数据库值与PercentageValue的转换，同时处理Admin表单的显示与输入：

from django.db import models
from django.forms import FloatField, TextInput

class PercentageField(models.FloatField):
    # 从数据库读取值时，包装为PercentageValue实例
    def from_db_value(self, value, expression, connection):
        if value is None:
            return value
        return PercentageValue(value)

    # 处理表单输入/初始值，转换为PercentageValue
    def to_python(self, value):
        if isinstance(value, PercentageValue):
            return value
        if value is None:
            return value
        # 处理用户输入的带%字符串（如"100%"）
        if isinstance(value, str):
            try:
                raw_value = float(value.replace('%', '').strip())
                return PercentageValue(raw_value)
            except ValueError:
                raise models.ValidationError("请输入有效的百分比格式，例如：100% 或 50.5")
        # 处理数字类型
        return PercentageValue(float(value))

    # 保存到数据库前，转换为原始float值
    def get_prep_value(self, value):
        if isinstance(value, PercentageValue):
            return value.value
        if isinstance(value, str):
            return float(value.replace('%', '').strip())
        return super().get_prep_value(value)

    # 自定义Admin表单的输入组件，显示带%的格式
    def formfield(self, **kwargs):
        class PercentageInput(TextInput):
            def format_value(self, value):
                if value is None:
                    return ''
                return str(value)

        kwargs['form_class'] = FloatField
        kwargs['widget'] = PercentageInput
        return super().formfield(**kwargs)

3. 在模型中使用自定义字段 #

直接替换原有的FloatField即可：

class YourModel(models.Model):
    discount_rate = PercentageField(verbose_name="折扣率")
    # 其他字段...

效果说明 #

• 模板渲染：直接使用{{ your_model_instance.discount_rate }}会自动显示为带%的格式（如数据库存100.00则显示"100%"）。
• Admin后台：列表页自动显示格式化后的百分比，表单页输入框会显示带%的内容，提交时自动去除%转换为数值存入数据库。

为什么之前的尝试无效？ #

你之前重写的to_python、__str__是针对字段类本身，但模板和Admin渲染的是字段的数值（float类型），而非字段类实例。通过包装数值为PercentageValue对象，让渲染时调用的是该对象的__str__方法，才实现了全局自动格式化。

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