Python包独立运行与作为其他仓库子模块运行导入冲突问题求助

核心原因 #

你遇到的导入冲突本质是Python两种运行模式的差异：

• 直接执行python run.py时，run.py会被识别为顶层__main__模块，系统不认为它属于bpt包，因此相对导入失效
• 作为brain_seg的子模块导入时，bpt被识别为合法包，相对导入正常生效

方案1（推荐，符合Python规范） #

保持run.py内的相对导入写法不变，调整独立运行时的启动命令：
不要进入bpt目录直接执行python run.py，而是在bpt的上级目录执行以下命令：

python -m bpt.run

该命令会将bpt识别为合法包，相对导入逻辑正常生效，同时完全兼容brain_seg项目的导入场景，不需要修改任何代码，也符合PEP8中包运行的规范，后续打包发布也不会有问题。

方案2（兼容直接运行run.py的需求） #

修改run.py的导入逻辑，自动适配两种运行场景：

import os
import sys

# 适配两种导入场景
if __name__ == '__main__' and __package__ is None:
    # 直接运行场景，将当前文件所在目录加入导入路径
    sys.path.append(os.path.dirname(os.path.abspath(__file__)))
    import module1
    import module2
else:
    # 作为包内模块导入场景，使用相对导入
    from . import module1
    from . import module2

修改后既可以直接执行python run.py，也可以在brain_seg项目中正常导入使用。

方案3（额外新增入口脚本） #

在bpt包的同级目录新增独立运行入口start_bpt.py，内容如下：

from bpt.run import main # 这里假设run.py的入口函数是main

if __name__ == '__main__':
    main()

run.py内保持相对导入写法不变，独立运行时执行python start_bpt.py即可，brain_seg项目的导入逻辑也不需要调整。

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