Docker容器内Jupyter Notebook导入上级目录模块失败的原因及更优解决方案咨询

为什么需要添加/usr/src/root/到sys.path才能成功导入？ #

这本质是Python的模块查找路径机制导致的问题：

• Python在导入模块时，只会从sys.path列表中的路径里搜索对应的模块/包。
• 当你在/usr/src/root/notebooks/myNotebook.ipynb中运行代码时，Jupyter会自动把当前工作目录（/usr/src/root/notebooks）加入到sys.path中，但它的上级目录（/usr/src/root/）并不会自动被添加进去。
• 你的folderA包位于/usr/src/root/下，而这个路径不在默认的sys.path里，所以直接执行from folderA... import ...时，Python找不到这个模块，抛出ModuleNotFoundError。

至于相对导入失败（ImportError: attempted relative import with no known parent package），是因为Jupyter Notebook的代码执行环境是脚本模式而非包模式：Python不会把当前的notebooks目录识别为一个包的一部分，所以用..尝试向上引用父目录的包时，Python无法确定相对的父包是什么，导致报错。

更优雅的替代方案 #

你的sys.path.append方法虽然有效，但属于“硬编码路径”，不够灵活。这里有几个更优雅的解决思路：

1. 从项目根目录启动Jupyter Notebook

这是最简单的方案：在Docker容器中，不要从/usr/src/root/notebooks目录启动Jupyter，而是切换到项目根目录/usr/src/root/再启动：

cd /usr/src/root/
jupyter notebook --notebook-dir=/usr/src/root/notebooks

这样Jupyter会自动把/usr/src/root/加入到sys.path中，你在myNotebook.ipynb里直接执行：

from folderA.folderB.folderC.classFileName import MyClass

就能成功导入了。

2. 设置PYTHONPATH环境变量

在启动Jupyter Notebook之前，把项目根目录添加到PYTHONPATH环境变量中。比如在Docker的启动脚本或者容器内的终端中执行：

export PYTHONPATH="/usr/src/root/:$PYTHONPATH"
jupyter notebook --notebook-dir=/usr/src/root/notebooks

PYTHONPATH是Python用来查找模块的环境变量，设置后，无论从哪个目录启动Jupyter，sys.path里都会包含/usr/src/root/，导入语句不需要任何修改。

3. 将项目作为可安装的开发包（适合长期维护的项目）

如果你的项目是一个可复用的包，推荐在/usr/src/root/下创建一个setup.py（或者现代Python项目推荐的pyproject.toml），然后用开发模式安装：

• 示例setup.py内容：

from setuptools import setup, find_packages

setup(
    name="myproject",
    version="0.1",
    packages=find_packages(),
)

• 然后在容器内执行：

cd /usr/src/root/
pip install -e .

这会把你的项目以“开发模式”安装到Python环境中，此时无论你在哪个目录运行代码（包括Jupyter Notebook），都能直接导入folderA下的模块，完全不需要修改sys.path。

备注：内容来源于stack exchange，提问作者X-L