Python中Enum类实例属性值的参数类型注解如何定义？

你遇到的问题根源在于：Colour.Red.value是运行时求值的表达式，而PEP-586规定Literal的类型参数必须是字面量常量（int/str/bool/bytes的直接值）或Enum实例，不能是动态计算的结果，因此Pylance会抛出警告。

以下是几种可行的解决方案，按维护性和优雅度排序：

方案1：Python 3.11+ 使用StrEnum（推荐） #

Python 3.11引入的StrEnum让枚举成员本身就是字符串类型，且成员值等于对应的字符串字面量。这样既可以用Enum成员作为Literal的参数，又能直接接收对应的字符串值（符合你的函数入参场景），同时避免了重复定义：

from typing import Literal
from enum import StrEnum

class Colour(StrEnum):
    Red = "1"
    Blue = "2"
    Green = "3"

def myfunc(input_str: Literal[Colour.Red, Colour.Blue, Colour.Green]) -> str:
    return input_str

# 两种调用方式均通过类型检查
myfunc(Colour.Red.value)  # 传入枚举值
myfunc("1")               # 传入字面量字符串

优点：完全绑定枚举定义，维护成本低，类型检查精准。

方案2：用常量统一管理枚举值（兼容所有Python版本） #

先定义枚举值对应的常量，再让枚举和Literal都引用这些常量，避免重复编写字面量，同时符合Literal的语法要求：

from typing import Literal
from enum import Enum

# 定义统一的常量
RED_VAL = "1"
BLUE_VAL = "2"
GREEN_VAL = "3"

class Colour(Enum):
    Red = RED_VAL
    Blue = BLUE_VAL
    Green = GREEN_VAL

def myfunc(input_str: Literal[RED_VAL, BLUE_VAL, GREEN_VAL]) -> str:
    return input_str

优点：兼容所有Python版本，修改枚举值时只需改动常量，无需同步修改类型注解。

方案3：直接写字面量（简单但维护性差） #

如果场景简单且枚举值很少变动，也可以直接在Literal中写字符串字面量：

from typing import Literal
from enum import Enum

class Colour(Enum):
    Red = "1"
    Blue = "2"
    Green = "3"

def myfunc(input_str: Literal["1", "2", "3"]) -> str:
    return input_str

缺点：枚举值和类型注解完全分离，修改枚举值时必须手动同步更新Literal，容易出错。

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