如何为Django models.TextChoices实现动态Literal类型注解？

要给函数参数添加基于Django TextChoices的严格类型注解，同时避免硬编码字符串字面量，你可以采用以下可行方案：

方法一：基于TextChoices成员值定义Literal类型别名 #

直接引用MedalType枚举成员的value属性构建Literal类型，既不用硬编码字符串，又能让mypy这类静态检查工具识别合法参数值：

from typing import Literal
from django.db import models

class Olympian(models.Model):
    MedalType = models.TextChoices('MedalType', 'GOLD SILVER BRONZE')
    medal = models.CharField(max_length=6, choices=MedalType.choices, default=MedalType.GOLD)

# 定义类型别名，关联MedalType的成员值
MedalLiteral = Literal[
    Olympian.MedalType.GOLD.value,
    Olympian.MedalType.SILVER.value,
    Olympian.MedalType.BRONZE.value
]

# 使用类型别名注解函数参数
def fn_with_type_hint(medal: MedalLiteral) -> None:
    # 函数逻辑
    pass

这种方式的优势很明显：后续修改MedalType的选项值时，类型注解会自动同步，无需手动调整Literal内容；静态检查工具会严格校验传入参数，非法字符串会被及时提示。

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

• medal: Olympian.medal：Olympian.medal是Django的模型字段对象，并非合法的类型注解，静态检查器无法识别。
• Literal[*Olympian.MedalType.values]：Python类型注解不支持在Literal中使用*展开语法，静态检查工具无法解析这种写法。

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