如何解决Python中两个类的循环依赖问题？

针对你遇到的Scheduler和SystemCall在同一模块的循环依赖，核心问题出在静态类型注解的提前引用，而运行时的isinstance判断其实不会有问题（因为调用run方法时两个类都已经定义完成）。下面是几种简单可行的解决方式：

1. 使用字符串类型注解（最简便） #

Python 3.7+支持PEP 484的字符串形式类型注解，直接把还未定义的类名用字符串包裹，类型检查器（如mypy）能正常识别，运行时也不会报错：

class Scheduler:
    def run(self):
        while self.task_map:
            task = self.ready_queue.get()
            result = task.run()
            if isinstance(result, SystemCall):
               result.set_task_and_scheduler(task, self)

class SystemCall:
    # 用字符串引用还未定义的Scheduler和Task类
    def set_task_and_scheduler(self, task: 'Task', scheduler: 'Scheduler') -> None:
        if not isinstance(scheduler, Scheduler):
            print(f'scheduler must be of type Scheduler')

2. 利用TYPE_CHECKING常量隔离类型注解 #

通过typing模块的TYPE_CHECKING常量，让类型相关的代码只在静态检查时生效，运行时完全跳过，避免循环引用：

from typing import TYPE_CHECKING

# TYPE_CHECKING在运行时为False，仅类型检查工具会执行此块代码
if TYPE_CHECKING:
    # 提前声明类的占位符，供类型注解使用
    class Scheduler: pass
    class Task: pass

class Scheduler:
    def run(self):
        while self.task_map:
            task = self.ready_queue.get()
            result = task.run()
            if isinstance(result, SystemCall):
               result.set_task_and_scheduler(task, self)

class SystemCall:
    # 直接使用类型注解，类型检查器能识别，运行时不会报错
    def set_task_and_scheduler(self, task: Task, scheduler: Scheduler) -> None:
        if not isinstance(scheduler, Scheduler):
            print(f'scheduler must be of type Scheduler')

3. 重构为依赖抽象（适合长期维护） #

如果想彻底消除循环依赖，可以定义抽象协议，让两个类依赖抽象而非具体实现：

from typing import Protocol

class SchedulerProtocol(Protocol):
    # 定义Scheduler需要暴露的方法/属性
    task_map: dict
    ready_queue: ...

class SystemCall:
    def set_task_and_scheduler(self, task: 'Task', scheduler: SchedulerProtocol) -> None:
        if not isinstance(scheduler, SchedulerProtocol):
            print(f'scheduler must implement SchedulerProtocol')

class Scheduler:
    def run(self):
        while self.task_map:
            task = self.ready_queue.get()
            result = task.run()
            if isinstance(result, SystemCall):
               result.set_task_and_scheduler(task, self)

这样SystemCall依赖的是抽象协议，而非具体的Scheduler类，后续拆分到不同模块也不会有问题。

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