Python类内方法引用自身类型引发AttributeError问题求助

问题原因 #

在类定义内部引用自身类型时，直接写Range会因为类还未完全定义导致IDE提示未解析引用；而写extensions.Range则会触发模块初始化阶段的循环引用错误——因为Range类还没完成定义，模块extensions还处于部分初始化状态，无法直接通过模块访问该类。

可行解决方案 #

1. 使用字符串字面量标注类型 #

将参数类型用单引号或双引号包裹，Python运行时会延迟解析类型提示，IDE也能正确识别：

from dataclasses import dataclass
from datetime import date

@dataclass
class Range:
    start: date
    end: date

    def overlap(self, other: 'Range') -> bool:
        # 方法实现
        ...

2. 导入__future__ annotations（Python 3.7+） #

在文件开头添加该导入后，所有类型提示都会被当作字符串处理，无需手动加引号：

from __future__ import annotations
from dataclasses import dataclass
from datetime import date

@dataclass
class Range:
    start: date
    end: date

    def overlap(self, other: Range) -> bool:
        # 方法实现
        ...

3. 使用Self类型（Python 3.11+） #

从typing模块导入Self，直接指代当前类，代码更清晰：

from dataclasses import dataclass
from datetime import date
from typing import Self

@dataclass
class Range:
    start: date
    end: date

    def overlap(self, other: Self) -> bool:
        # 方法实现
        ...

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