如何在不实例化Python dataclass时获取属性类型用于类型提示

针对你遇到的无法直接用Pizza.price这类属性做类型提示的问题，有几个实用且规范的方案：

1. 显式定义全局类型别名 #

最直观的方式是把属性对应的类型提取成全局别名，既保持代码整洁，又能直接在类型提示中使用：

from dataclasses import dataclass
from typing import Annotated

# 提前定义类型别名
PizzaPrice = Annotated[float, "money"]
PizzaSize = Annotated[float, "dimension"]
ToppingSauce = Annotated[str, "matter"]

@dataclass
class Pizza:
    price: PizzaPrice
    size: PizzaSize

    @dataclass
    class Topping:
        sauce: ToppingSauce

# 直接用别名做类型提示
def calculate_cost(cost: PizzaPrice) -> float:
    # some_calculation
    return cost

这种方式完全符合类型提示规范，主流类型检查器（如mypy、Pyright）都能正常识别，同时让属性的类型定义更清晰。

2. 定义类内部类型别名 #

如果不想把类型别名暴露在全局作用域，可以将其定义在类内部，保持类型与类的关联：

from dataclasses import dataclass
from typing import Annotated

@dataclass
class Pizza:
    # 类内部定义类型别名
    PriceType = Annotated[float, "money"]
    SizeType = Annotated[float, "dimension"]
    
    price: PriceType
    size: SizeType

    @dataclass
    class Topping:
        SauceType = Annotated[str, "matter"]
        sauce: SauceType

# 通过类引用内部别名
def calculate_cost(cost: Pizza.PriceType) -> float:
    # some_calculation
    return cost

这种写法和引用嵌套类的格式一致，无需区分属性和类的引用方式。

3. 字符串形式的类型提示（规范可行） #

你提到的字符串形式（如"Pizza.price"）是完全符合PEP 484规范的，主流类型检查器都支持这种写法。它属于前向引用的扩展用法，不仅适用于类，也能用于类属性的类型引用：

def calculate_cost(cost: "Pizza.price") -> float:
    # some_calculation
    return cost

这种写法无需额外定义别名，适合快速引用属性类型的场景。

不推荐的方式 #

Pizza.__annotations__["price"]这类写法仅适合运行时获取类型信息，静态类型检查器无法识别，会导致类型检查失效，不建议用于类型提示。

内容的提问来源于stack exchange，提问作者sams-studio