我有一个类似于以下内容的目录结构

meta_project
    project1
        __init__.py
        lib
            module.py
            __init__.py
    notebook_folder
        notebook.jpynb

当在工作notebook.jpynb，如果我尝试使用相对导入来访问函数function()在module.py有：

from ..project1.lib.module import function

我收到以下错误：

SystemError                               Traceback (most recent call last)
<ipython-input-7-6393744d93ab> in <module>()
----> 1 from ..project1.lib.module import function

SystemError: Parent module '' not loaded, cannot perform relative import

有什么办法可以使用相对导入来使它起作用？

注意，笔记本服务器是在meta_project目录级别实例化的，因此它应该有权访问这些文件中的信息。

同样要注意的是，至少没有按照最初的意图project1被认为是模块，因此没有__init__.py文件，它只是作为文件系统目录。如果解决问题的方法需要将其视为模块，并包括一个__init__.py很好的文件（甚至是空白文件），但这样做还不足以解决问题。

我在机器之间共享此目录，相对的导入使我可以在任何地方使用相同的代码，而且我经常使用笔记本进行快速原型制作，因此涉及将绝对路径捆绑在一起的建议不太可能有帮助。

编辑：这与Python 3中的相对导入不同，后者相对于Python 3中的相对导入一般来说，尤其是从包目录中运行脚本。这与在jupyter笔记本中工作有关，该笔记本试图调用另一个目录中具有不同常规和特定方面的本地模块中的函数。

在此笔记本中，我有一个与您几乎相同的示例，在此我想以DRY方式说明相邻模块功能的用法。

我的解决方案是通过向笔记本中添加如下代码段来告知Python该额外的模块导入路径：

import os
import sys
module_path = os.path.abspath(os.path.join('..'))
if module_path not in sys.path:
    sys.path.append(module_path)

这使您可以从模块层次结构中导入所需的功能：

from project1.lib.module import function
# use the function normally
function(...)

请注意，如果还没有空__init__.py文件，则必须将它们添加到project1 /和lib /文件夹中。

在这里使用笔记本时，正在寻求将代码抽象到子模块的最佳实践。我不确定是否有最佳做法。我一直在提出这个建议。

这样的项目层次结构：

├── ipynb
│   ├── 20170609-Examine_Database_Requirements.ipynb
│   └── 20170609-Initial_Database_Connection.ipynb
└── lib
    ├── __init__.py
    └── postgres.py

来自20170609-Initial_Database_Connection.ipynb：

    In [1]: cd ..

    In [2]: from lib.postgres import database_connection

之所以可行，是因为默认情况下Jupyter Notebook可以解析该cd命令。请注意，这没有利用Python Notebook魔术。它只是工作而无需前置%bash。

考虑到我使用Project Jupyter Docker映像之一在Docker中工作的100次中有99次，以下修改是幂等的

    In [1]: cd /home/jovyan

    In [2]: from lib.postgres import database_connection

到目前为止，已接受的答案对我来说效果最好。但是，我一直担心的是，在某些情况下，我可能会将notebooks目录重构为子目录，从而需要module_path在每个笔记本中进行更改。我决定在每个笔记本目录中添加一个python文件，以导入所需的模块。

因此，具有以下项目结构：

project
|__notebooks
   |__explore
      |__ notebook1.ipynb
      |__ notebook2.ipynb
      |__ project_path.py
   |__ explain
       |__notebook1.ipynb
       |__project_path.py
|__lib
   |__ __init__.py
   |__ module.py

我project_path.py在每个笔记本子目录（notebooks/explore和notebooks/explain）中添加了文件。此文件包含相对导入的代码（来自@metakermit）：

import sys
import os

module_path = os.path.abspath(os.path.join(os.pardir, os.pardir))
if module_path not in sys.path:
    sys.path.append(module_path)

这样，我只需要在project_path.py文件中而不是在笔记本中进行相对导入即可。然后，笔记本文件仅需要在导入project_path之前导入lib。例如在0.0-notebook.ipynb：

import project_path
import lib

需要注意的是，逆转进口将行不通。这不起作用：

import lib
import project_path

因此在进口期间必须小心。

我刚刚找到了这个漂亮的解决方案：

import sys; sys.path.insert(0, '..') # add parent folder path where lib folder is
import lib.store_load # store_load is a file on my library folder

您只需要该文件的某些功能

from lib.store_load import your_function_name

如果python版本> = 3.3，则不需要文件夹中的init.py文件

我自己研究此主题并阅读答案，因此我建议使用path.py库，因为该库提供了用于更改当前工作目录的上下文管理器。

然后你有类似的东西

import path
if path.Path('../lib').isdir():
    with path.Path('..'):
        import lib

虽然，您可能只是省略了isdir声明。

在这里，我将添加打印语句，以便于跟踪正在发生的事情

import path
import pandas

print(path.Path.getcwd())
print(path.Path('../lib').isdir())
if path.Path('../lib').isdir():
    with path.Path('..'):
        print(path.Path.getcwd())
        import lib
        print('Success!')
print(path.Path.getcwd())

在此示例中输出（其中lib在/home/jovyan/shared/notebooks/by-team/data-vis/demos/lib）：

/home/jovyan/shared/notebooks/by-team/data-vis/demos/custom-chart
/home/jovyan/shared/notebooks/by-team/data-vis/demos
/home/jovyan/shared/notebooks/by-team/data-vis/demos/custom-chart

由于该解决方案使用上下文管理器，因此无论内核在单元之前处于什么状态，以及导入库代码引发了什么异常，都可以保证返回到先前的工作目录。

这是我的2美分：

导入系统

映射模块文件所在的路径。就我而言，它是台式机

sys.path.append（'/ Users / John / Desktop'）

要么导入整个映射模块，要么然后使用.notation来映射诸如mapping.Shipping（）的类。

导入映射＃mapping.py是我的模块文件的名称

shipit = mapping.Shipment（）#Shipment是我需要在映射模块中使用的类的名称

或从映射模块导入特定的类

从映射导入映射

shipit = Shipment（）＃现在，您不必使用.notation

我发现python-dotenv可以非常有效地解决此问题。您的项目结构最终会稍有变化，但是笔记本中的代码在笔记本之间更简单，更一致。

对于您的项目，请进行一些安装。

pipenv install python-dotenv

然后，项目更改为：

├── .env (this can be empty)
├── ipynb
│   ├── 20170609-Examine_Database_Requirements.ipynb
│   └── 20170609-Initial_Database_Connection.ipynb
└── lib
    ├── __init__.py
    └── postgres.py

最后，您的导入更改为：

import os
import sys

from dotenv import find_dotenv


sys.path.append(os.path.dirname(find_dotenv()))

此软件包的+1是您的笔记本可以位于多个目录中。python-dotenv将在父目录中找到最接近的目录并使用它。此方法的+2是jupyter将在启动时从.env文件加载环境变量。双重打击。