如何在不修改客户端代码的前提下支持Python包的多版本兼容

你之前的实现仅将选中版本的foo模块作为lib包的属性导入，没有在Python的模块查找系统中注册lib.foo这个模块路径，因此客户端执行from lib.foo import f时会提示模块不存在。

两种方案都可以完全兼容原有客户端导入逻辑：

方案1：注册虚拟模块（推荐） #

直接在lib/__init__.py中将选中的foo模块注册到sys.modules的lib.foo路径下，Python导入时会优先读取sys.modules中的已注册模块，无需调整文件结构。
lib/__init__.py完整代码：

import os
import sys

# 版本选择逻辑
if os.environ.get("USE_V2", "0") == "0":
    from .v1 import foo
else:
    from .v2 import foo

# 核心逻辑：将选中版本的foo模块注册为lib.foo
sys.modules["lib.foo"] = foo

如果后续需要扩展多个子模块，也可以按照同样逻辑批量注册到sys.modules，无需新增额外文件。

方案2：新增代理模块文件 #

在lib目录下新建一个foo.py代理文件，动态导出对应版本的全部内容，原有目录结构仅新增这一个文件即可。
lib/foo.py代码：

import os

if os.environ.get("USE_V2", "0") == "0":
    from .v1.foo import *
    from .v1.foo import __all__, __doc__, __file__
else:
    from .v2.foo import *
    from .v2.foo import __all__, __doc__, __file__

这种方法更直观，适合需要代理的模块数量较少的场景，后续维护修改逻辑更简单。

如果foo模块下还存在多级子模块，需要按照对应路径在sys.modules中递归注册子模块，或者对应层级都新增代理文件，即可保证全部导入路径兼容。

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