Python中使用@typechecked装饰器时如何规避循环导入？

在循环导入场景中，既要用@typechecked做运行时类型验证，又要避免导入报错，可通过以下几种方案解决：

1. 使用字符串类型注解 + from __future__ import annotations #

利用Python 3.7+的from __future__ import annotations特性，让类型注解以字符串形式存储，运行时不会立即解析，同时配合TYPE_CHECKING导入满足静态类型检查。typeguard支持解析字符串形式的类型注解，能在运行时正确识别目标类型。

修改controllers.py如下：

# controllers.py
from __future__ import annotations
from typing import TYPE_CHECKING
from typeguard import typechecked

if TYPE_CHECKING:
    from models import Book

class BookController:
    
    @typechecked
    def __init__(self, book: "Book") -> None:
        self.book = book

如果担心命名冲突，也可以使用完整模块路径的字符串：

def __init__(self, book: "models.Book") -> None:

此方案无需调整模块结构，是最简便的解决方式。

2. 运行时延迟导入 #

在需要类型验证的函数内部（而非模块顶部）导入依赖类型，避免模块加载时的循环导入。Python的导入机制会缓存模块，因此不会重复加载。

修改controllers.py：

# controllers.py
from __future__ import annotations
from typing import TYPE_CHECKING
from typeguard import typechecked

if TYPE_CHECKING:
    from models import Book

class BookController:
    
    @typechecked
    def __init__(self, book: Book) -> None:
        # 运行时才导入，避开模块初始化阶段的循环依赖
        from models import Book
        self.book = book

3. 重构模块结构（彻底消除循环依赖） #

将循环依赖的类型抽离到独立的公共模块，让原模块从公共模块导入类型，从根源上解决循环导入问题。

比如新建common.py存放共享类型：

# common.py
class Book:
    pass

修改models.py：

# models.py
from controllers import BookController
from common import Book
from typeguard import typechecked

# 扩展公共模块的Book类
class Book(Book):
    @typechecked
    def get_controller(self, some_bookcontroller: BookController):
        return some_bookcontroller

some_book = Book()
BookController("somestring")

修改controllers.py：

# controllers.py
from typeguard import typechecked
from common import Book

class BookController:
    @typechecked
    def __init__(self, book: Book) -> None:
        self.book = book

关于typeguard的专属"TYPE_CHECKING"布尔值 #

typeguard本身没有类似TYPE_CHECKING的专属布尔值，但可以通过上述方案，结合Python原生的TYPE_CHECKING和字符串注解特性，实现静态类型检查与运行时验证的兼容。

内容的提问来源于stack exchange，提问作者a.t.