如何让Python模块在不同层级入口下无需修改导入语句即可正常运行？

项目结构 #

main.py
module1/
    subMain.py  
    script1.py  
    script2.py  
    submodule1/
        script3.py
module2/
    script4.py  

现象说明 #

• 直接运行subMain.py时，代码正常工作：

  # subMain.py
  from script1 import *
  
  # script1.py
  from submodule1.script3 import *
  

• 运行main.py时，原导入语句报错：

  # main.py
  # 这一行正常
  from module1.script1 import *
  
  # script1.py中以下语句运行失败
  from submodule1.script3 import *
  
  # 修改为下面的语句才能正常运行
  from module1.submodule1.script3 import *
  

疑问：有没有办法不用修改script1.py里的导入语句，让它在两种场景下都能正常运行？

解决方案 #

方法1：使用相对导入（推荐） #

给module1和submodule1目录都添加空的__init__.py文件（让Python将其识别为正规包），然后把script1.py里的导入改成相对路径：

# script1.py
from .submodule1.script3 import *

这种写法是Python包的标准导入方式，不管是从subMain.py还是main.py导入，都能正确解析路径。

方法2：修改subMain.py的Python路径 #

如果坚持不想改script1.py的代码，可以在subMain.py开头添加代码，把项目根目录（main.py所在目录）加入Python的搜索路径：

# subMain.py
import sys
import os

# 获取当前文件所在目录的父目录（即项目根目录）
root_path = os.path.dirname(os.path.abspath(__file__))
sys.path.append(root_path)

# 后续正常导入
from script1 import *

这样subMain.py运行时，Python会从项目根目录开始查找模块，和main.py的运行环境一致，原导入语句就能生效。

方法3：用-m参数运行subMain.py #

不要直接用python subMain.py运行，而是切换到项目根目录下，用模块方式运行：

python -m module1.subMain

这种运行方式会自动把项目根目录加入Python路径，让script1.py的导入逻辑和main.py调用时保持一致，无需修改任何代码。

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