使用Pydantic V2时，如何优雅解决跨文件类互引的循环依赖？

问题背景 #

我在两个不同文件中定义了Snapshot和View类，存在以下依赖关系：

• Snapshot类的view实例方法返回View类实例
• View类的构造需要传入Snapshot类实例
  要求全程正确使用Pydantic V2的类型检查机制，但当前实现用TYPE_CHECKING和get_snapshot_class()的方式感觉是取巧的临时方案，想知道有没有更优解。

当前实现代码 #

snapshot.py

from __future__ import annotations
from typing import TYPE_CHECKING
from pydantic import BaseModel

if TYPE_CHECKING:
    from .view import View


class Snapshot(BaseModel):
    position: str

    def view(self, context: str) -> "View":
        # Delay import to avoid circular import
        from .view import View

        return View(snapshot=self, context=context)

view.py

from pydantic import BaseModel


def get_snapshot_class():
    from qcs.snapshot import Snapshot

    return Snapshot


class View(BaseModel):
    snapshot: "get_snapshot_class()"
    context: str

更优解决方案 #

利用Pydantic V2对字符串类型注解的原生支持，结合from __future__ import annotations消除循环导入问题，同时保证类型检查和运行时验证正常工作：

优化后的snapshot.py #

from __future__ import annotations
from typing import TYPE_CHECKING
from pydantic import BaseModel

# 仅在类型检查阶段导入View，不影响运行时
if TYPE_CHECKING:
    from .view import View


class Snapshot(BaseModel):
    position: str

    def view(self, context: str) -> View:
        # 运行时延迟导入View，避免循环引用
        from .view import View
        return View(snapshot=self, context=context)

优化后的view.py #

from __future__ import annotations
from pydantic import BaseModel


class View(BaseModel):
    # 使用字符串注解直接引用Snapshot，Pydantic V2会自动解析
    snapshot: "Snapshot"
    context: str

方案说明 #

1. 类型检查阶段：from __future__ import annotations让所有类型注解以字符串形式保留，结合TYPE_CHECKING条件导入，静态检查工具（如mypy）能正确识别类型关系，不会报错。
2. 运行时阶段：Pydantic V2会自动解析字符串形式的类型注解，在需要验证时动态查找对应的类；view方法内的延迟导入避免了循环导入导致的运行时错误。
3. 相比原方案，去掉了冗余的get_snapshot_class()函数，代码更简洁直观，完全符合Pydantic V2的设计规范，不是临时取巧的方案。

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