如何在 Python 中灵活切换同名包的导入库

通过动态赋值模块变量，可轻松实现多版本同名包的无缝切换，既保持 `package.module.function()` 的清晰调用语法，又避免硬编码路径或重复修改导入语句。

在实际项目中，常遇到多个第三方库或内部版本（如 lib1 和 lib2）提供结构完全一致的子包（如 p1、p2），但需根据环境、配置或运行时条件灵活选用其中一套。此时，若直接使用 from lib1.p1 import * 会丢失命名空间，无法通过 p1.f() 调用；而每次修改 import 语句又违背“一次配置、全局生效”的工程原则。

✅ 推荐做法：模块别名 + 动态绑定
不依赖 __import__ 或 importlib 的复杂逻辑，而是将目标库作为模块对象统一赋值给一个顶层变量（如 current_lib），再显式暴露其子包：

# config.py —— 集中配置点，仅修改此处即可切换底层库
import lib1  # 或 import lib2
current_lib = lib1  # ← 切换开关：改为 lib2 即可

# 在 main.py 中统一使用
from config import current_lib

# 清晰、可读、IDE 友好：支持自动补全与类型提示
result = current_lib.p1.some_function()
output = current_lib.p2.another_method(42)

? 优势说明：

• ✅ 保留完整包路径语义（current_lib.p1.f()），避免命名冲突；
• ✅ 所有导入集中于 config.py，符合单一职责原则；
• ✅ 支持静态分析工具（如 mypy、pylint）和主流 IDE（PyCharm、VS Code）的跳转与补全；
• ✅ 可扩展为运行时切换（例如结合 os.environ.get("LIB_VERSION") 动态导入）；
• ❌ 避免 from lib import * 导致的命名污染与调试困难。

⚠️ 注意事项：

• 确保 lib1 和 lib2 的接口严格兼容（函数签名、异常行为、返回类型一致），否则切换后可能引发静默错误；
• 若需热重载或插件化场景，可进一步封装为 LibManager 类，配合 importlib.reload()（但生产环境慎用）；
• 不建议在 __init__.py 中做条件导入，易导致循环引用或导入时序问题。

总结：用一个轻量级配置模块承载库选择逻辑，以模块对象为桥梁，既满足可维护性，又不牺牲代码可读性与开发体验。