Python3同包模块跨目录调用导入冲突问题求助

问题复现 #

先还原你的目录结构和核心代码：

├── main.py
└── mypkg
    ├── barlib.py
    ├── foolib.py
    ├── __init__.py
    └── pmain.py

各文件核心代码：

• foolib.py：

  def foo():
      print("I'm foo!")
  

• barlib.py（第一种写法：包内运行正常，父目录调用报错）：

  from foolib import foo
  def bar():
      foo()
      print("I'm bar!")
  

• pmain.py：

  from barlib import bar
  bar()
  

• main.py：

  from mypkg.barlib import bar
  bar()
  

你遇到的两种报错场景：

1. 使用第一种barlib.py写法时，运行main.py触发报错：

   Traceback (most recent call last):
   File "main.py", line 1, in
   from mypkg.barlib import bar
   File "/xxxxx/mypkg/barlib.py", line 1, in
   from foolib import foo
   ModuleNotFoundError: No module named 'foolib'

2. 把barlib.py改成from mypkg.foolib import foo后，运行pmain.py触发报错：

   Traceback (most recent call last):
   File "mypkg/pmain.py", line 1, in
   from barlib import bar
   File "/xxxxx/mypkg/barlib.py", line 1, in
   from mypkg.foolib import foo
   ModuleNotFoundError: No module named 'mypkg'

问题本质 #

这一切都是Python**模块搜索路径（sys.path）**在不同运行场景下的差异导致的：

• 当你在mypkg目录内直接运行pmain.py时，sys.path的第一个元素是mypkg目录本身，所以from foolib import foo能直接找到同目录的foolib.py；但此时父目录不在搜索路径里，from mypkg.foolib import foo就找不到mypkg这个包。
• 当你运行父目录的main.py时，sys.path的第一个元素是父目录，Python会把mypkg当作一个包处理，此时barlib.py里的from foolib import foo会去父目录找foolib.py，而它实际在mypkg目录下，自然找不到。

两种导入写法对应的搜索逻辑，无法同时适配两种运行场景，所以出现了顾此失彼的报错。

解决方案 #

最推荐的是使用Python官方提倡的包内相对导入，能完美兼容两种运行场景：

方案1：用相对导入修改barlib.py #

把barlib.py的导入语句改成相对路径形式：

from .foolib import foo  # 点号表示当前包目录下的模块

def bar():
    foo()
    print("I'm bar!")

修改后：

• 运行父目录的main.py：Python将mypkg识别为包，.foolib会精准指向包内的foolib.py，正常导入；
• 运行包内的pmain.py：不管是在mypkg目录内直接运行，还是在父目录执行python mypkg/pmain.py，相对导入都能正确找到同目录的foolib.py。

注意：相对导入只能在包内部的模块中使用，不能直接把barlib.py当作独立脚本运行（比如python mypkg/barlib.py），但你的场景里barlib.py是被导入的模块，完全不受影响。

方案2：统一用模块方式运行脚本（绝对导入方案） #

如果你更习惯用绝对导入，可以通过统一运行方式来适配：

1. 修改barlib.py为绝对导入：

   from mypkg.foolib import foo
   def bar():
       foo()
       print("I'm bar!")
   

2. 修改pmain.py的导入语句：

   from mypkg.barlib import bar
   bar()
   

3. 从父目录运行pmain.py时，使用模块执行方式：

   python -m mypkg.pmain
   

这种方式下，Python会自动把父目录加入sys.path，同时将mypkg当作包处理，不管是main.py还是pmain.py都能正常运行。缺点是不能在mypkg目录内直接运行pmain.py，必须从父目录用模块方式执行。

方案3：手动修改sys.path（不推荐） #

作为临时应急方案，可以在pmain.py开头手动将父目录加入搜索路径：

import sys
import os
# 把当前文件的父目录（即项目根目录）加入sys.path
sys.path.append(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))

from mypkg.barlib import bar
bar()

但这种方式依赖固定的目录结构，一旦目录移动就会失效，代码耦合性高，不推荐在正式项目中使用。

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