如何在单个Django模型字段中存储比特币与USD？

要在同一个字段结构下处理USD和比特币（以聪为最小单位），核心思路是用一个字段存储金额数值，再搭配一个额外字段标记货币类型——毕竟如果没有类型标记，你根本无法区分数据库里的数值到底是USD还是BTC。下面是两种成熟的实现方案，附带优缺点分析：

方案1：用DecimalField存储实际货币值 #

这种方案更直观，直接存储USD或BTC的实际数值，搭配货币类型字段区分：

模型设计 #

from django.db import models
from decimal import Decimal

class Transaction(models.Model):
    # 定义货币选项，方便后续验证和展示
    CURRENCY_CHOICES = [
        ('USD', 'US Dollar'),
        ('BTC', 'Bitcoin'),
    ]
    # 配置足够精度：BTC需要8位小数（对应聪），USD仅需2位，所以decimal_places设为8
    # max_digits设为20，足够覆盖大额的USD或BTC数值
    amount = models.DecimalField(max_digits=20, decimal_places=8)
    currency = models.CharField(max_length=3, choices=CURRENCY_CHOICES)
    
    # 封装展示用的属性，方便前端或后台显示
    @property
    def display_amount(self):
        if self.currency == 'USD':
            # USD格式化到两位小数，显示为$10.50的形式
            return f"${self.amount.quantize(Decimal('0.00'))}"
        elif self.currency == 'BTC':
            # 可同时显示BTC和聪的数值
            satoshi = int(self.amount * Decimal('100000000'))
            return f"{self.amount} BTC ({satoshi} satoshi)"

优缺点 #

• ✅ 数据库数值直观，无需转换就能看懂（比如10.50000000就是10.5美元，0.00000001就是1聪）
• ✅ 处理USD时无需额外转换，直接用两位小数即可
• ❌ 相比整数存储，极端场景下的计算效率稍低

方案2：用BigIntegerField存储最小单位的整数 #

这种方案更适合加密货币场景，完全用整数存储最小单位（USD的“分”，BTC的“聪”），彻底规避精度问题：

模型设计 #

from django.db import models
from decimal import Decimal

class Transaction(models.Model):
    CURRENCY_CHOICES = [
        ('USD', 'US Dollar'),
        ('BTC', 'Bitcoin'),
    ]
    # 用BigIntegerField存储最小单位数量：1美元=100分，1BTC=100000000聪
    amount_in_minor_unit = models.BigIntegerField()
    currency = models.CharField(max_length=3, choices=CURRENCY_CHOICES)
    
    # 封装转换为实际货币值的属性
    @property
    def amount_as_decimal(self):
        if self.currency == 'USD':
            return Decimal(self.amount_in_minor_unit) / Decimal('100')
        elif self.currency == 'BTC':
            return Decimal(self.amount_in_minor_unit) / Decimal('100000000')
    
    # 封装展示属性
    @property
    def display_amount(self):
        amount = self.amount_as_decimal
        if self.currency == 'USD':
            return f"${amount.quantize(Decimal('0.00'))}"
        elif self.currency == 'BTC':
            return f"{amount} BTC ({self.amount_in_minor_unit} satoshi)"

优缺点 #

• ✅ 完全避免浮点/Decimal的精度问题，整数计算绝对准确，适合加密货币的高精度需求
• ✅ 数据库存储和计算效率更高
• ❌ 数据库中的数值需要转换才能看懂（比如1050代表10.5美元，1代表1聪）

关键提醒 #

绝对不要尝试在没有货币类型标记的情况下，用单个字段存储两种货币——那样的数值完全没有意义，你根本无法判断它是USD还是BTC。必须搭配currency字段明确类型，这是实现的核心前提。

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