Python嵌套目录导入报错：ImportError: attempted relative import无已知父包

问题根源 #

当你通过python Baselines/random/random.py直接运行脚本时，Python会将该脚本所在的Baselines/random目录加入模块搜索路径sys.path，而项目根目录（Project）不在路径内，导致绝对导入找不到Utils；同时直接运行的脚本没有包层级上下文，相对导入也会触发报错。

可行解决方案 #

方案1：手动添加项目根目录到sys.path

在random.py的最顶部添加以下代码，强制将项目根目录加入模块搜索路径：

import os
import sys
# 获取当前脚本的绝对路径所在目录
current_dir = os.path.dirname(os.path.abspath(__file__))
# 向上两级定位到Project根目录
project_root = os.path.dirname(os.path.dirname(current_dir))
# 把根目录加入sys.path
sys.path.append(project_root)

# 现在可以正常导入
from Utils.general_utils import *

方案2：以模块方式运行random.py（符合Python包规范）

修改main.py中的os.system调用命令，从直接运行脚本改为以模块方式启动：

# main.py中的调用代码
os.system("python -m Baselines.random.random")

此时random.py作为Project包下的子模块运行，可直接使用绝对导入：

from Utils.general_utils import *

或者使用对应层级的相对导入：

# 从Baselines.random向上两级到Project根，再定位Utils
from ...Utils.general_utils import *

方案3：直接导入模块调用（最优解）

避免用os.system启动新进程，直接在main.py中导入模块并调用逻辑：

1. 先在random.py中把执行逻辑封装成函数：

# random.py
def main():
    # 原脚本的业务逻辑写在这里
    pass

2. 在main.py中直接导入调用：

# main.py
from Baselines.random.random import main

main()

这种方式完全不需要处理路径问题，Python会自动基于项目根目录解析模块导入。

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