Python中按需导入typing包：仅调试加载，生产环境不加载

方法一：使用字符串形式的类型注解 #

Python运行时不会解析字符串格式的类型注解，而mypy等静态分析工具可以正常识别。这样生产环境无需导入typing包也不会报错：

import os

if os.getenv('DEBUG'):
    from typing import Any, Optional

def myfunc(self, param: str) -> 'Any':
    # 函数逻辑
    pass

核心是把类型注解用单引号包裹，变成字符串，运行时不会尝试解析Any这个对象，仅在静态检查时被工具识别。

方法二：利用typing.TYPE_CHECKING常量 #

TYPE_CHECKING是typing模块提供的常量，运行时始终为False，只有静态分析工具执行时才会被设为True。结合字符串注解可以彻底避免运行时导入typing：

from typing import TYPE_CHECKING

if TYPE_CHECKING:
    # 仅在静态检查时执行导入
    from typing import Any, Optional

def myfunc(self, param: str) -> 'Any':
    # 函数逻辑
    pass

这种方式更精准：只有做类型检查时才会导入类型，生产环境完全不会加载typing包。

方法三：Python 3.10+ 启用延迟注解 #

Python 3.10及以上版本可以通过__future__导入让所有类型注解自动变成字符串，无需手动加引号：

from __future__ import annotations
from typing import TYPE_CHECKING

if TYPE_CHECKING:
    from typing import Any, Optional

def myfunc(self, param: str) -> Any:
    # 函数逻辑
    pass

from __future__ import annotations会让所有注解延迟到需要时才求值，运行时注解只是字符串，所以即使没导入Any也不会触发报错，同时不影响静态分析工具的正常工作。

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