如何在Python中为父属性/参数添加类型注解且避免循环依赖？

针对你遇到的循环依赖问题，这里有几种实用方案来为Wheel类的parent属性添加类型注解：

方案一：字符串形式的类型注解（Python 3.7+） #

直接将类型注解写成字符串"Car"，无需导入Car模块，类型检查工具（如mypy）完全可以识别这种写法，同时避免了运行时的循环导入。

修改后的wheel.py代码：

class Wheel():
    def __init__(self, parent: "Car", desc: str) -> None:
        self._car = parent
        self._desc = desc

方案二：利用TYPE_CHECKING条件导入 #

typing模块中的TYPE_CHECKING常量仅在类型检查阶段为True，运行时会被解析为False。借助它可以实现仅在类型检查时导入Car，不影响运行逻辑。

修改后的wheel.py代码：

from typing import TYPE_CHECKING

# 仅类型检查时执行导入，运行时跳过
if TYPE_CHECKING:
    from .car import Car

class Wheel():
    def __init__(self, parent: Car, desc: str) -> None:
        self._car = parent
        self._desc = desc

方案三：使用ForwardRef显式声明前置引用（Python 3.6+） #

通过typing.ForwardRef显式声明尚未定义的类型，这是字符串注解的更正式写法。在Python 3.9及以后版本中，字符串注解会自动被视为ForwardRef，因此该方案更适配旧版本Python。

修改后的wheel.py代码：

from typing import ForwardRef

# 声明对Car的前置引用
Car = ForwardRef("Car")

class Wheel():
    def __init__(self, parent: Car, desc: str) -> None:
        self._car = parent
        self._desc = desc

内容的提问来源于stack exchange，提问作者Shai Ben-Dor