如何解决Python中‘attempted relative import with no known parent package’错误

问题根源 #

直接运行file2.py时，Python会将其视为顶层脚本文件，而非某个包的子模块，这导致相对导入语法from ..foo.file import File无法识别父包结构，从而抛出错误。

可行解决方案 #

1. 以包模块的方式运行脚本 #

从project1目录下，使用-m参数以模块形式启动file2，Python会自动识别包结构：

# 先切换到project1目录
cd /path/to/projects/project1
# 用模块路径运行，不要加.py后缀
python3 -m folder1.bar.file2

2. 改用绝对导入并添加根路径到sys.path #

如果需要直接运行file2.py，可以手动将项目根目录加入Python的模块搜索路径，再使用绝对导入：
修改bar/file2.py的开头代码：

import sys
from pathlib import Path

# 获取project1目录的绝对路径（根据文件层级向上回溯）
project_root = Path(__file__).parent.parent.parent
sys.path.append(str(project_root))

# 改用绝对导入
from folder1.foo.file import File
from file2Interface import File2Interface

class File2(File2Interface):
    def __init__(self):
        ...

    def func2(self):
        f = File()  # 注意：Python没有new关键字，这里要修正
        f.func()
        ...

之后就可以直接运行file2.py：

python3 /path/to/projects/project1/folder1/bar/file2.py

3. 确认__init__.py文件存在 #

确保folder1、foo、bar三个目录下都有__init__.py文件（空文件即可），这是Python识别包目录的必要条件。

你之前尝试的操作问题说明 #

• python3 -m file2.py错误：-m参数后应跟模块路径（如folder1.bar.file2），而非带.py后缀的文件名
• python3 folder1/bar/file2.py直接运行：此时file2.py被当作顶层脚本，相对导入无法识别父包结构

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