如何不使用__future__ annotations让Pylance识别类型表达式中的Schema类

问题核心是类内部的成员变量名Schema和导入的Schema类同名，导致Pylance解析type[Schema]时，误将其识别为类内部的变量而非外部导入的类。以下是两种不依赖from __future__ import annotations的解决方案：

方案1：给导入的Schema类起别名 #

通过重命名导入的类，彻底避免命名冲突，Pylance能准确识别类型，同时保留原有成员变量名和代码补全高亮：

from dataclasses import dataclass
from typing import ClassVar

from marshmallow import Schema as MarshmallowSchema
from marshmallow_dataclass import add_schema


@add_schema
@dataclass(frozen=True)
class A:
    name: str

    Schema: ClassVar[type[MarshmallowSchema]] = MarshmallowSchema


A().Schema().load()

方案2：使用字符串类型注解 #

将类型注解用引号包裹，让Pylance将其视为前向引用，优先解析外部导入的Schema类，同样能保留补全高亮：

from dataclasses import dataclass
from typing import ClassVar

from marshmallow import Schema
from marshmallow_dataclass import add_schema


@add_schema
@dataclass(frozen=True)
class A:
    name: str

    Schema: ClassVar["type[Schema]"] = Schema


A().Schema().load()

两种方案都能解决警告问题，方案1的可读性和类型识别更清晰，推荐优先使用；方案2无需修改导入逻辑，适合不想调整命名的场景。

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