Python同目录模块导入与父目录调用的兼容性问题求助

这个问题本质是Python模块导入时的路径解析规则导致的——不同运行场景下，Python的sys.path（模块搜索路径）不一样，所以两种导入方式没法同时兼容两种运行情况。下面给你几个实用的解决方案：

方案1：使用相对导入（推荐，符合Python包规范） #

在function1.py里把导入语句改成：

from . import function2

这样做的好处是：

• 从main.py导入subDirec.function1时，Python会把subDirec当作一个包，相对导入.function2会正确指向同目录下的function2.py。
• 如果要直接运行function1.py，不要直接用python subDirec/function1.py，而是切换到project目录下，用模块方式运行：

  python -m subDirec.function1
  

  这种方式会把subDirec当作包来加载，相对导入就能正常工作。

方案2：手动添加项目根目录到模块搜索路径 #

如果你不想改变运行方式，可以在function1.py的最开头加上这段代码，把项目根目录加入sys.path：

import sys
from pathlib import Path

# 获取当前脚本的父目录的父目录（也就是project目录）
project_root = Path(__file__).parent.parent
sys.path.append(str(project_root))

然后function1.py里继续用import subDirec.function2就行。这样不管是直接运行function1.py还是从main.py调用，Python都能找到subDirec包。不过这种方式有点“hack”，如果后续项目结构变动，可能需要调整路径计算逻辑。

方案3：统一运行工作目录 #

始终把project目录作为工作目录来运行脚本：

1. 切换到project目录下
2. 运行main.py：

   python main.py
   

3. 运行function1.py：

   python subDirec/function1.py
   

同时把function1.py里的导入改成：

from subDirec import function2

因为此时project目录在sys.path里，Python能直接找到subDirec包，不管是从main调用还是直接跑function1，导入都能正常工作。

为什么原来的方式会报错？ #

• 当你在function1.py里用import subDirec.function2，直接运行function1.py时，当前工作目录是subDirec，sys.path里没有project目录，Python找不到subDirec这个包，所以报错。
• 当你改成import function2，从main.py运行时，main的工作目录是project，Python会在project目录下找function2.py，而不是subDirec目录里，所以找不到就报错了。

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