Python执行相对导入提示无已知父包ImportError解决方案咨询

这个报错的本质是直接运行单脚本时，Python无法识别当前文件的包层级关系：

• 当你用./file.py直接执行脚本时，Python会把这个文件当做顶层入口模块，此时它的__name__属性为__main__，没有对应的父包上下文，自然解析不了..这类跨层级的相对导入语法。
• 你当前的目录结构里，folder1和folder2是平级关系，仅在folder2下加__init__.py只能标记folder2为包，两个文件夹共同所在的上级目录既没有被纳入Python模块搜索路径，也没有被标记为包，相对导入找不到参照基准。
• 补充：如果要让Python把folder1识别为包，最好也在folder1目录下添加一个空的__init__.py文件，兼容不同Python版本的导入规则。

方案1：改用模块方式运行（改动最小，最符合Python包规范） #

不要进入folder2目录直接执行脚本，退到folder1和folder2共同所在的项目根目录，用-m参数按模块路径启动：

python -m folder2.file

这种运行方式下Python会自动把当前工作目录作为顶层模块搜索路径，正确识别folder2的包属性，..会指向项目根目录，就能正常导入平级的folder1。

方案2：修改导入逻辑，支持直接运行脚本 #

如果一定要保留./file.py的直接执行方式，就放弃相对导入，在文件开头手动把项目根目录加入Python搜索路径，改用绝对导入：

#!/usr/bin/env python3
import sys
from pathlib import Path
# 将当前文件上两级目录（即项目根目录）加入模块搜索路径
sys.path.append(str(Path(__file__).parent.parent.resolve()))

# 直接用绝对路径导入folder1
import folder1

改完后直接执行./file.py就不会再报导入错误。

方案3：规范化项目结构（适合正式开发场景） #

把所有可导入的包统一收拢到单独的顶层源码目录下，比如新建src目录，把folder1、folder2都移入src并在src下添加__init__.py，项目根目录只放启动入口脚本，不要直接把包内的模块作为执行入口，从根源上避免相对导入的上下文丢失问题。

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