Django继承CharField自定义字段如何实现通用默认参数设置

Django项目开发中需要实现可复用的自定义模型字段，以CurrencyField为例，需要为字段预置默认参数：

• 将verbose_name的默认值设为“Mena”
• 固定max_length为5
• 绑定预设的货币选项枚举

原有实现运行时会触发报错，问题代码行如下：

kwargs['verbose_name'] = kwargs['verbose_name'] or 'Mena'

报错核心原因：Django模型字段的verbose_name是__init__方法的第一个位置参数，如果使用时将verbose_name作为位置参数传入，该值不会出现在kwargs字典中，直接访问kwargs['verbose_name']会抛出KeyError。同时用or判断默认值的逻辑存在缺陷，会覆盖用户主动传入的空字符串等合法值。

原有问题代码如下：

class CurrencyChoices(models.TextChoices):
    EUR = 'EUR'
    CHF = 'CHF'
    CZK = 'CZK'
    DKK = 'DKK'
    GBP = 'GBP'
    HRK = 'HRK'
    HUF = 'HUF'
    PLN = 'PLN'
    RON = 'RON'
    SEK = 'SEK'
    USD = 'USD'

class CurrencyField(models.CharField):

    def __init__(self, *args, **kwargs):
        kwargs['verbose_name'] = kwargs['verbose_name'] or 'Mena'
        kwargs['max_length'] = 5
        kwargs['choices'] = CurrencyChoices.choices
        super().__init__(*args, **kwargs)

from django.db import models

class CurrencyChoices(models.TextChoices):
    EUR = 'EUR'
    CHF = 'CHF'
    CZK = 'CZK'
    DKK = 'DKK'
    GBP = 'GBP'
    HRK = 'HRK'
    HUF = 'HUF'
    PLN = 'PLN'
    RON = 'RON'
    SEK = 'SEK'
    USD = 'USD'

class CurrencyField(models.CharField):
    def __init__(self, *args, **kwargs):
        # 写入强制固定参数，不允许用户自定义覆盖
        kwargs['max_length'] = 5
        kwargs['choices'] = CurrencyChoices.choices

        # 优先从位置参数取verbose_name：CharField第一个位置参数固定为verbose_name
        verbose_name = None
        if args:
            verbose_name = args[0]
            args = args[1:]
        
        # 位置参数未传时，从关键字参数中取值
        if verbose_name is None:
            verbose_name = kwargs.pop('verbose_name', None)
        
        # 仅当用户未传入任何verbose_name值时，才使用预设默认值
        kwargs['verbose_name'] = verbose_name if verbose_name is not None else 'Mena'

        super().__init__(*args, **kwargs)

• 强制固定的参数（如本场景中的max_length、choices）直接写入kwargs即可，无论用户传入什么值都会被覆盖，符合自定义字段的封装预期。
• 处理verbose_name时优先读取位置参数，读取后要将该参数从args元组中移除，避免调用父类__init__时出现重复传参错误。
• 从kwargs读取verbose_name时使用pop方法并设置默认值为None，避免KeyError。
• 判断是否使用默认值时，仅判断取值是否为None，不要使用or逻辑，防止用户主动传入的空字符串、False等合法值被错误替换为默认值。

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