Python子目录模块导入失败求助：相对导入报未知父包错误

错误原因 #

直接运行menu/main_screen.py时，Python会将其视为独立的顶级脚本，而非Project包的一部分，因此相对导入语法..无法识别父包结构，抛出ImportError: attempted relative import with no known parent package（中文：导入错误：尝试进行相对导入，但未知父包）。

可行解决方案 #

方案1：以包模块形式运行 #

从Project的父目录执行命令，将Project作为包来运行脚本：

python -m Project.menu.main_screen

这种方式会让Python识别Project的包结构，原相对导入代码from ..objects.button import Button即可正常工作。

方案2：动态添加项目根目录到sys.path #

在main_screen.py开头添加代码，手动将Project根目录加入Python模块搜索路径，之后使用绝对导入：

import sys
import os

# 获取Project根目录的绝对路径
project_root = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
sys.path.insert(0, project_root)

# 现在可以直接导入objects下的模块
from objects.button import Button
from objects.text import Text

注：之前sys.path.insert无效大概率是因为添加的路径不是Project根目录，而是子目录，导致objects模块不在搜索范围内。

方案3：设置PYTHONPATH环境变量 #

将Project根目录添加到系统的PYTHONPATH环境变量中：

• Windows终端：

  set PYTHONPATH=你的Project目录绝对路径
  

• Linux/macOS终端：

  export PYTHONPATH=/你的/Project/目录绝对路径
  

设置完成后，直接运行main_screen.py，即可使用from objects.button import Button这类绝对导入语句。

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