如何解决Python项目ImportError: attempted relative import beyond top-level package错误

• 相对导入的层级判定依赖当前脚本的包身份：当你直接运行单个Python文件（比如python test_cartesian_product.py或者直接在cartesianproduct目录下运行python __main__.py）时，Python会将运行的脚本视为顶级执行模块，不会将其识别为项目包结构的一部分，此时..对应的父层级超出了Python识别的顶级包范围，触发报错。
• 你的__main__.py中存在拼写错误：项目中的测试目录名为test，但导入语句写的是tests，也会额外触发导入失败。

方案1：调整运行方式（最规范，无需修改代码） #

不要在cartesianproduct目录内部直接运行脚本，切换到cartesianproduct的上级目录，通过Python的模块运行参数-m执行，命令如下：

# 运行主程序
python -m cartesianproduct.__main__
# 单独运行测试文件
python -m cartesianproduct.test.test_cartesian_product

这种方式Python会自动识别完整的包层级，相对导入可以正常生效，同时需要先把__main__.py中的导入修正为from test import test_cartesian_product_package。

方案2：改为绝对导入（兼容直接运行脚本的场景） #

修改test_cartesian_product.py的导入逻辑，开头先把项目根目录加入Python模块搜索路径，再用绝对路径导入：

import sys
from pathlib import Path
# 将cartesianproduct的上级目录加入模块搜索路径
sys.path.append(str(Path(__file__).parent.parent.parent.resolve()))
# 改为绝对导入
from cartesianproduct import sequences_operations
from cartesianproduct import sequence_creation

修改后直接运行测试文件或者__main__.py都可以正常生效。

方案3：使用测试框架运行用例 #

如果是跑单元测试，直接用pytest等测试框架执行即可，pytest会自动将项目根目录加入模块搜索路径，你只需要把测试文件的相对导入改为绝对导入：

from cartesianproduct import sequences_operations
from cartesianproduct import sequence_creation

在项目根目录下执行pytest命令就能正常跑通所有测试。

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