跨文件夹导入Python模块报错，如何适配不同运行路径？

问题根源 #

Python的模块查找逻辑依赖当前运行脚本的工作目录和sys.path列表：

• 从根目录运行foo.py时，根目录被加入sys.path，foofunc1.py里的from foofunc2 import func2会在根目录下找foofunc2.py，自然找不到；
• 若在foodir内部运行脚本，foodir被加入sys.path，改成from foodir.foofunc2 import func2又会因找不到foodir包报错。

无需修改导入语句的解决方案 #

方案1：将foodir转为Python包（推荐） #

1. 在foodir目录下创建空的__init__.py文件，使其成为可识别的Python包：

   foo.py
   │
   └─── foodir/
       │
       └─── __init__.py
       └─── foofunc1.py
       └─── foofunc2.py
   

2. 修改foofunc1.py的导入为相对导入：

   from .foofunc2 import func2
   

   这里的.代表当前包（foodir），无论从根目录运行foo.py，还是在foodir内直接运行脚本，相对导入都会基于包结构定位模块，不受工作目录影响。

方案2：统一注入根目录到sys.path #

如果不想调整导入语句，可在需要运行的脚本开头手动添加根目录到sys.path：

• 对于foodir内的脚本（如foofunc1.py），添加以下代码：

  import sys
  from pathlib import Path
  
  # 获取根目录路径（foo.py所在目录）
  root_dir = Path(__file__).parent.parent
  sys.path.append(str(root_dir))
  

  这样无论在哪运行脚本，根目录都会被加入模块查找路径，from foodir.foofunc2 import func2和根目录运行foo.py的导入逻辑都能正常工作。

方案3：以模块方式运行脚本 #

始终从根目录用-m参数启动脚本：

• 运行foo.py：

  python foo.py
  

• 运行foodir内的foofunc1.py：

  python -m foodir.foofunc1
  

  这种方式会自动将根目录作为包的顶层目录加入sys.path，无论用绝对导入还是相对导入，都能适配两种运行场景。

总结 #

优先选择方案1，这是Python模块化开发的标准做法，彻底规避工作目录带来的导入问题。若无法调整导入语句，方案2或3可作为替代。

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