Python3跨目录导入遇ImportError：相对导入无已知父包

错误原因 #

直接运行file3.py时，Python会将其视为顶层执行脚本，而非包的一部分，这时候相对导入from ..a.file1 import *无法识别包的层级结构，就会抛出ImportError: attempted relative import with no known parent package。

可行解决方案 #

方案1：以包的形式运行脚本 #

假设a和b的共同父目录为project，打开终端进入project目录，执行以下命令运行file3.py：

python -m b.file3

这种方式会让Python识别整个目录结构为包，相对导入语句from ..a.file1 import *就能正常工作。

方案2：修改sys.path并使用绝对导入 #

保留你添加sys.path的逻辑，但将相对导入改为绝对导入，修改file3.py代码如下：

import os
import sys

# 获取a和b的共同父目录
parent_dir = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
# 将父目录加入Python搜索路径
sys.path.append(parent_dir)

# 使用绝对导入替代相对导入
from a.file1 import *

之前的问题在于你虽然添加了路径，但仍在使用相对导入，而顶层脚本不支持相对导入，换成绝对导入即可解决。

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

终端运行时配置

在Debian终端中，先设置PYTHONPATH为项目根目录（即a和b的父目录），再运行脚本：

export PYTHONPATH=/path/to/your/project/root:$PYTHONPATH
python b/file3.py

VSCode中配置

在VSCode的.vscode/launch.json中添加环境变量配置，让运行时自动将项目根目录加入Python路径：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python: Current File",
            "type": "python",
            "request": "launch",
            "program": "${file}",
            "env": {
                "PYTHONPATH": "${workspaceFolder}"
            }
        }
    ]
}

配置完成后，直接在VSCode中运行file3.py，使用绝对导入from a.file1 import *即可正常导入。

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