如何实现Python工具对依赖库多个LTS版本的兼容支持？

方案1：发布对应不同依赖版本的工具包 #

仅适合依赖版本差异极大、后续两个LTS版本还会长期独立迭代的场景，你当前只有10处左右的差异点，完全没必要使用该方案。维护两份代码会成倍提升迭代成本，同时用户安装时很容易选错版本，后续问题排查也更复杂。

方案2：调用处添加版本判断 #

实现最直接，适合差异点少、逻辑简单的场景：

1. 首先全局获取一次依赖库的版本：

from importlib.metadata import version
import main_lib

# 只在模块加载时检测一次版本
MAIN_LIB_VERSION = tuple(map(int, version("main_lib").split(".")))

2. 在有差异的调用处直接判断版本分支：

if MAIN_LIB_VERSION >= (2, 0):
    main_lib.display_name(name, param_2)
else:
    main_lib.display_name(name)

该方案逻辑直白，无需额外封装，排查问题时可以直接看到调用分支，10处差异的场景下维护成本很低。

方案3：装饰器版本自动分发 #

你期望的装饰器写法完全可以实现，实现逻辑如下：
首先实现版本分发的装饰器：

from importlib.metadata import version
from functools import wraps
import main_lib

# 全局检测依赖版本
MAIN_LIB_VERSION = tuple(map(int, version("main_lib").split(".")))
# 存储不同函数对应的各版本实现
_version_dispatch_map = {}

def lib_ves(matched_version: tuple):
    def decorator(func):
        func_key = func.__qualname__
        if func_key not in _version_dispatch_map:
            _version_dispatch_map[func_key] = {}
        # 注册对应版本的实现
        _version_dispatch_map[func_key][matched_version] = func

        @wraps(func)
        def dispatcher(*args, **kwargs):
            # 按版本从高到低匹配最适配的实现
            for ver in sorted(_version_dispatch_map[func_key].keys(), reverse=True):
                if MAIN_LIB_VERSION >= ver:
                    return _version_dispatch_map[func_key][ver](*args, **kwargs)
            raise NotImplementedError(f"未找到适配main_lib {MAIN_LIB_VERSION}版本的实现")
        return dispatcher
    return decorator

之后就可以按照你期望的写法实现不同版本的逻辑：

@lib_ves((1, 0))
def my_lib_method(self, args):
    # 1.0版本逻辑
    main_lib.display_name(name)

@lib_ves((2, 0))
def my_lib_method(self, args):
    # 2.0版本逻辑
    main_lib.display_name(name, param_2)

该方案可以实现不同版本逻辑的完全解耦，后续新增LTS版本时只需要新增对应装饰器修饰的实现即可，无需修改原有逻辑。

额外推荐方案：统一适配层封装 #

对于10处左右的差异点，更推荐把所有和依赖库交互的差异逻辑都统一放到单独的适配模块中，对外暴露统一的调用接口，上层业务代码完全无需感知依赖版本：

# adapter.py 适配层
from importlib.metadata import version
import main_lib

MAIN_LIB_VERSION = tuple(map(int, version("main_lib").split(".")))

# 对外暴露统一的display_name接口
def display_name(name, param_2=None):
    if MAIN_LIB_VERSION >= (2, 0):
        return main_lib.display_name(name, param_2)
    return main_lib.display_name(name)

上层业务代码直接调用适配层的统一接口即可：

from adapter import display_name
# 无需判断版本，直接传参调用
display_name(name, param_2)

所有版本兼容逻辑都收敛到同一个适配文件中，后续迭代、排查问题都只需要修改适配层，不需要改动上层业务代码。

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