使用全局变量的装饰器遭mypy报错，如何解决？

你遇到的问题是：通过装饰器结合global实现模块延迟加载时，代码运行正常，但mypy无法识别被装饰函数中使用的全局变量，报出“Name is not defined”错误；注释global语句则会导致运行时失败。以下是几种可行的解决办法：

方法1：借助TYPE_CHECKING添加仅用于类型检查的导入 #

利用typing.TYPE_CHECKING常量（仅在类型检查阶段为True），在被装饰函数所在模块的顶部添加“伪导入”，让mypy识别变量的同时，不影响运行时的延迟加载逻辑。

示例代码：

from typing import TYPE_CHECKING

# 仅在类型检查时执行导入，运行时自动跳过
if TYPE_CHECKING:
    from os import getcwd

def load_getcwd(func):
    def inner(*args, **kwargs):
        global getcwd
        from os import getcwd
        return func(*args, **kwargs)
    return inner

@load_getcwd
def print_dir():
    print(getcwd())

print_dir()

这种方式既满足了mypy的类型检查要求，又保留了装饰器延迟加载模块的核心功能。

方法2：修改装饰器，将导入的函数作为参数传递 #

避免使用global，改为把延迟导入的函数作为参数传入被装饰函数，让变量来源显式化，mypy能直接识别变量定义。

修改后的代码示例：

def load_getcwd(func):
    def inner(*args, **kwargs):
        from os import getcwd
        # 将延迟导入的函数作为参数传递给原函数
        return func(getcwd, *args, **kwargs)
    return inner

@load_getcwd
def print_dir(getcwd):
    print(getcwd())

print_dir()

这种写法更符合Python的“显式优于隐式”原则，完全消除mypy报错的同时，代码可读性更强。

方法3：使用mypy忽略注释快速解决 #

如果不想调整代码结构，可以在报错行添加# type: ignore注释，强制mypy忽略该变量的未定义检查：

def load_getcwd(func):
    def inner(*args, **kwargs):
        global getcwd
        from os import getcwd
        return func(*args, **kwargs)
    return inner

@load_getcwd
def print_dir():
    print(getcwd())  # type: ignore

print_dir()

注意：这种方式会屏蔽该行的所有类型检查，仅适合小型项目或临时场景使用。

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