导入含同名models包的两个Git仓库时遇命名空间冲突问题求助

核心问题 #

两个仓库（AdaBins、BLIP）的models包都作为顶级模块导入时，Python模块查找机制会优先加载先找到的版本，后续导入直接复用缓存模块，导致调用时路径混淆。

无需修改外部依赖的解决方法 #

方法1：绝对路径导入 #

直接从仓库根目录指定完整导入路径，明确区分两个models包：

# 导入BLIP的模型模块
from BLIP.models import blip
# 导入AdaBins的模型模块
from AdaBins.models import unet_adaptive_bins

# 调用示例
blip.blip_infer_function()
unet_adaptive_bins.infer()

这种方式最直接，Python会根据完整路径定位正确模块，不会出现混淆。

方法2：动态导入并指定别名 #

如果仓库内部存在相对导入问题，用importlib手动加载模块并赋予别名，规避命名冲突：

import importlib.util
import sys

# 加载AdaBins的models模块并命名为adabins_models
spec = importlib.util.spec_from_file_location("adabins_models", "./AdaBins/models/__init__.py")
adabins_models = importlib.util.module_from_spec(spec)
sys.modules["adabins_models"] = adabins_models
spec.loader.exec_module(adabins_models)

# 加载BLIP的models模块并命名为blip_models
spec = importlib.util.spec_from_file_location("blip_models", "./BLIP/models/__init__.py")
blip_models = importlib.util.module_from_spec(spec)
sys.modules["blip_models"] = blip_models
spec.loader.exec_module(blip_models)

# 调用示例
adabins_models.unet_adaptive_bins.infer()
blip_models.blip.some_function()

方法3：临时切换sys.path+清理模块缓存 #

如果必须用import models的方式，严格控制导入顺序并清理缓存：

import sys
import importlib

# 导入BLIP的models并别名
sys.path.insert(0, "./BLIP")
import models as blip_models
sys.path.pop(0)
importlib.reload(blip_models)

# 清理models缓存，避免影响后续导入
if "models" in sys.modules:
    del sys.modules["models"]

# 导入AdaBins的models并别名
sys.path.insert(0, "./AdaBins")
import models as adabins_models
sys.path.pop(0)
importlib.reload(adabins_models)

# 调用示例
blip_models.blip.xxx()
adabins_models.unet_adaptive_bins.infer()

为什么之前的方法无效？ #

Python会将已导入的模块缓存到sys.modules中，即使修改sys.path，再次import models时仍直接读取缓存，不会重新查找路径。你之前的操作未彻底清理缓存，或导入时未明确模块归属，导致冲突持续存在。

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