在Django的模型开发中，DecimalField是处理高精度数值的常用字段，默认情况下它会对超出精度的数值进行四舍五入处理。但在金融计算、库存统计等业务场景中，往往需要截断多余的小数位而不是四舍五入，比如计算商品单价时保留两位小数的截断结果，避免四舍五入带来的金额误差。
DecimalField默认的数值处理逻辑
Django的DecimalField底层依赖Python的decimal模块，当传入的数值小数位超过字段定义的max_digits和decimal_places时，默认会调用decimal的量化方法进行四舍五入。比如定义字段为DecimalField(max_digits=5, decimal_places=2)，传入数值3.145时，保存后的值会是3.15，而不是我们想要的3.14。
实现截断的三种方案
方案一：使用Python decimal模块手动截断
decimal模块提供了量化方法，我们可以指定截断模式来实现截断效果。decimal的ROUND_DOWN模式就是直接截断多余的小数位，不会进行进位操作。
首先在模型保存前对数值进行处理，重写模型的save方法：
from django.db import models
from decimal import Decimal, ROUND_DOWN
class Product(models.Model):
name = models.CharField(max_length=50)
# 定义保留两位小数的DecimalField
price = models.DecimalField(max_digits=10, decimal_places=2)
def save(self, *args, **kwargs):
if self.price is not None:
# 定义量化模板，保留两位小数
quantize_template = Decimal('0.00')
# 使用ROUND_DOWN模式截断
self.price = self.price.quantize(quantize_template, rounding=ROUND_DOWN)
super().save(*args, **kwargs)
这种方案适合单个模型字段的截断处理，逻辑简单，不需要额外定义新的字段类型。
方案二：自定义DecimalField截断字段
如果多个模型都需要使用截断的DecimalField，可以自定义一个字段类，统一处理截断逻辑，避免重复代码。
from django.db import models
from decimal import Decimal, ROUND_DOWN
class TruncateDecimalField(models.DecimalField):
def to_python(self, value):
# 先将值转换为Decimal类型
value = super().to_python(value)
if value is None:
return value
# 生成对应小数位的量化模板
quantize_template = Decimal(f"0.{'0' * self.decimal_places}")
# 执行截断操作
return value.quantize(quantize_template, rounding=ROUND_DOWN)
def get_prep_value(self, value):
if value is None:
return None
# 保存前也执行截断，避免直接操作数据库时出现问题
quantize_template = Decimal(f"0.{'0' * self.decimal_places}")
value = Decimal(str(value)).quantize(quantize_template, rounding=ROUND_DOWN)
return super().get_prep_value(value)
使用时直接替换原来的DecimalField即可：
class Order(models.Model):
order_id = models.CharField(max_length=30)
# 使用自定义的截断字段
total_amount = TruncateDecimalField(max_digits=12, decimal_places=2)
方案三：在表单或序列化器中处理
如果数值的截断只需要在接口层或者表单提交时生效，也可以在表单的clean方法或者序列化器的validate方法中处理，不需要修改模型层逻辑。
以Django REST framework的序列化器为例：
from rest_framework import serializers
from decimal import Decimal, ROUND_DOWN
from .models import Product
class ProductSerializer(serializers.ModelSerializer):
class Meta:
model = Product
fields = ['id', 'name', 'price']
def validate_price(self, value):
if value is None:
return value
quantize_template = Decimal('0.00')
return value.quantize(quantize_template, rounding=ROUND_DOWN)
不同方案的适用场景对比
| 方案 | 适用场景 | 优点 | 缺点 |
|---|---|---|---|
| 重写save方法 | 单个模型少量字段需要截断 | 逻辑简单，改动小 | 多个字段或模型需要重复编写代码 |
| 自定义字段 | 多个模型多个字段需要截断 | 复用性高，统一处理逻辑 | 需要额外定义字段类，理解成本稍高 |
| 表单/序列化器处理 | 仅接口层需要截断，模型层保留原始逻辑 | 不侵入模型层，灵活控制处理层级 | 直接操作模型对象时不会触发截断逻辑 |
注意事项
- 截断操作会直接丢弃多余的小数位，不会进行任何进位，使用前需要确认业务场景是否允许这种处理方式。
- 自定义字段时需要注意to_python和get_prep_value两个方法的重写，确保数据在读取和写入时都能正确截断。
- 如果数值是负数，ROUND_DOWN模式会向零方向截断，比如-3.145截断两位后会变成-3.14，符合大多数业务场景的预期。
实际开发中建议优先选择自定义字段的方案，既保证了逻辑的复用性，也不会侵入业务层的代码，后期维护成本更低。
DjangoDecimalField截断四舍五入decimal修改时间：2026-07-13 23:09:32