相对导入问题解决，ImportError:attempted relative import with no known parent package

前言

本文中，我将会分析报错 ImportError: attempted relative import with no known parent package 的原因。当运行python脚本，使用了相对引用方式 (类似import module) 去引用包时，可能会出现找不到父级包的异常。想直接看解决方案的朋友，可以直接跳到文章末尾。

问题

以以下目录为例，当从在module2.py文件中运行from .. import dir1时（module1与module2均为自定义的.py文件），python解释器报出以上错误。

.
├── run.py
└── Project
    ├── dir1
    │   └── module1.py 
    ├── dir2
    │   └── module2.py
    └── test.py

为了验证问题，在module2中添加以下代码

print('__file__={0:<35} | __name__={1:<20} | __package__={2:<20}'.format(__file__,__name__,str(__package__)))

运行结果显示： __name__ = __main__ 和 __package__ = None，python解释器没有关于模块所属的包的任何信息，因此它抛出了找不到父级包的异常。

尝试一

我尝试了参考博客2中的解决方案一，在dir1, dir2中创建一个新的空 __init__.py 文件来将项目目录转换为一个包。目录更新如下：

.
├── run.py
└── Project
    ├── dir1
    │   ├── __init__.py
    │   └── module1.py     
    ├── dir2
    │   ├── __init__.py
    │   └── module2.py
    └── test.py

但在分别运行以下两条import代码时，仍然报错。说明问题仍没有解决。

import dir1  #绝对导入
from .. import dir1  #相对导入

尝试二

我又尝试了参考博客1中的方法，添加命令from __future__ import absolute_import， 但是仍报错。

解决方案

尝试了以上两种相对导入的解决方法后，有点儿灰心，决定尝试绝对导入的方法，终于粗暴地把问题解决了。

首先使用python自带的sys模块，查看绝对导入的路径：

import sys
print(sys.path)

发现没有文件dir1，dir2的路径，那么直接在sys.path中添加其路径，即能成功导入了。以我的路径为例：

import sys
print(sys.path)
sys.path.append('/home/user/fqm/Project')
sys.path.append('/home/user/fqm/Project/dir1')
sys.path.append('/home/user/fqm/Project/dir2')
# '/home/user/fqm/'为示例的项目路径，换成你的即可

这样就能正常运行绝对导入import dir1，没有报错了。

---

参考博客

1，相对导入问题总结：attempted relative import with no known parent package

2，[译][python]ImportError:attempted relative import with no known parent package

3，解决python相对导入出现错误：Attempted relative import beyond toplevel package