Python 3.10.7相对导入报错：attempted relative import beyond top-level package

你的问题核心是直接运行脚本时，Python的包识别逻辑和IDE不一样：

为什么会报错？ #

当你直接执行python run_me.py时，Python会把run_me.py所在的Project目录当成脚本的工作目录，而非一个可导入的包。此时data_processor被视为顶层包，from ..class_one试图跳出这个顶层包去导入，自然会触发ImportError。

而IDE会自动把Project识别为项目根目录，并将其加入Python的模块搜索路径（sys.path），所以能正常解析相对导入并给出提示。

可行的解决方案 #

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

在Project的父目录下执行以下命令：

python -m Project.run_me

注意：需要在Project和data_processor目录下都创建空的__init__.py文件，让Python把它们识别为正式的包（Python3.3+支持无__init__.py的命名空间包，但加上兼容性更好）。

方案2：改用绝对导入并添加路径 #

1. 修改data_process.py里的导入语句为绝对导入：

from class_one import ClassOne

2. 在run_me.py的开头添加代码，把Project目录加入Python的模块搜索路径：

import sys
import os
# 获取当前脚本所在目录（即Project目录）
project_root = os.path.dirname(os.path.abspath(__file__))
sys.path.append(project_root)

这样Python就能找到同级的class_one.py文件了。

方案3：调整项目结构（可选） #

如果允许修改结构，把class_one.py移动到data_processor目录下，然后把导入语句改成：

from .class_one import ClassOne

这种方式最符合Python的包结构规范，后续不会再出现导入问题。

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