Python 如何优雅地处理可选依赖缺失并控制子类可用性？

2026-11-04数据阿明

结论

如果要求“只有安装了 pckg 才提供 Fancy”，可以在导入成功后再定义 Fancy(Basic)。如果希望调用方始终能导入 Fancy，可以保留类定义，在实例化时检查依赖并给出明确错误。

两种方式都应保证 Basic 不依赖 pckg，并且只处理预期的“找不到 pckg”异常。

原代码需要调整什么？

示例中，Basic 只计算 x * a，而 Fancy 需要调用 pckg.f(a)。因此，pckg 是增强功能的可选依赖。

如果导入失败后只执行 pass，后续使用 Fancy 时仍会访问未绑定的 pckg，通常会得到 NameError，难以看出真正的问题。

另外，原代码中的 class Fancy(): 没有继承 Basic。要表达子类关系，需要写成 class Fancy(Basic):。以下示例也补齐了 Python 所需的缩进。

方案一：依赖可用时才定义 Fancy

下面的代码适用于支持 ModuleNotFoundError 的 Python 3 环境：

try:
    import pckg
except ModuleNotFoundError as exc:
    if exc.name != "pckg":
        raise
    pckg = None


class Basic:
    def __call__(self, x, a):
        return x * a


if pckg is not None:
    class Fancy(Basic):
        def __call__(self, x, a):
            return x * pckg.f(a)

这样处理后：

找不到 pckg 时，模块仍能正常导入，Basic 可以使用。
成功导入 pckg 时，模块提供 Fancy。
如果 pckg 在导入过程中因其他依赖缺失而失败，异常会继续向外抛出。

例如，将代码保存为 features.py 后，调用方可以选择可用的实现：

import features

implementation = getattr(features, "Fancy", features.Basic)
operation = implementation()
result = operation(2, 3)

是否回退到 Basic 应由调用方决定，因为 x * a 与 x * pckg.f(a) 可能有不同的业务含义。只有接受默认功能时，才适合自动选用 Basic。

缺少依赖时，模块没有定义 Fancy，因此 from features import Fancy 会失败。这是该方案对外接口的一部分。

方案二：始终定义 Fancy，在实例化时检查依赖

如果希望模块始终暴露相同的类名，可以保留前面的导入处理和 Basic 定义，将条件定义部分替换为：

class Fancy(Basic):
    def __init__(self):
        if pckg is None:
            raise RuntimeError(
                "Fancy requires the optional dependency 'pckg'."
            )

    def __call__(self, x, a):
        return x * pckg.f(a)

这时 from features import Fancy 可以成功，但在缺少依赖的环境中执行 Fancy() 会立即报错。调用方在创建对象时就能发现问题，无需等到第一次调用对象。

这里使用 RuntimeError 表达当前环境无法启用增强功能；也可以根据项目约定定义专门的异常类型。

为什么不直接捕获所有导入异常？

假设 pckg 已经存在，但它内部执行 import another_dependency 时失败，也会抛出 ModuleNotFoundError。如果不检查异常的 name，就可能把安装损坏或间接依赖缺失误判为“没有安装可选包”。

对于示例中的顶层导入 import pckg，使用：

except ModuleNotFoundError as exc:
    if exc.name != "pckg":
        raise

可以区分缺少目标包与常见的内部依赖缺失情况。不要使用裸 except:，它还会捕获与依赖可用性无关的异常，甚至包括 KeyboardInterrupt 和 SystemExit。

以上实现以 pckg 提供可调用的 f 为前提。成功导入只能说明导入过程完成，不能保证安装版本一定具备所需 API。如果缺少 f，调用时仍会报错，应单独处理兼容性问题。