如何配置环境/服务器，实现子目录Notebook导入根目录自定义模块？

方法1：Notebook内临时添加根目录到Python路径 #

在需要导入模块的Notebook开头插入以下代码，手动将项目根目录（notebook-dir）加入Python的模块搜索路径：

import sys
from pathlib import Path

# 获取当前Notebook所在目录
current_dir = Path.cwd()
# 根据实际目录层级定位根目录，比如当前在子目录则用parent回退
root_dir = current_dir.parent  # 若根目录是绝对路径，可直接写Path("/你的/notebook-dir路径")
sys.path.append(str(root_dir))

# 现在可以正常导入自定义模块
import my_module

这种方式仅对当前Notebook生效，无需修改系统或服务器配置，适合临时测试场景。

方法2：启动服务器前设置PYTHONPATH环境变量 #

在启动Jupyter Notebook服务器的终端中，先将根目录添加到PYTHONPATH，再启动服务：

• Linux/macOS：

  export PYTHONPATH="/path/to/notebook-dir:$PYTHONPATH"
  jupyter notebook
  

• Windows（命令提示符）：

  set PYTHONPATH=C:\path\to\notebook-dir;%PYTHONPATH%
  jupyter notebook
  

• Windows（PowerShell）：

  $env:PYTHONPATH = "C:\path\to\notebook-dir;$env:PYTHONPATH"
  jupyter notebook
  

此方法对该终端启动的所有Notebook实例生效，无需在每个Notebook中重复添加路径代码。

方法3：将根目录转为Python包 #

在项目根目录（notebook-dir）下创建空的__init__.py文件，把根目录标记为Python包。之后子目录中的Notebook可通过相对导入调用模块：

# 假设Notebook位于notebook-dir/subdir下，导入根目录的my_module
from .. import my_module

注意：相对导入依赖严格的目录层级，建议配合方法2使用，避免因Notebook工作目录变化导致导入失败。

方法4：自定义启动脚本简化配置 #

创建启动脚本，自动完成环境变量配置并启动服务器：

• Linux/macOS：创建start_notebook.sh

  #!/bin/bash
  export PYTHONPATH="/path/to/notebook-dir:$PYTHONPATH"
  jupyter notebook
  

  赋予执行权限：chmod +x start_notebook.sh，之后直接运行脚本即可。
• Windows：创建start_notebook.bat

  @echo off
  set PYTHONPATH=C:\path\to\notebook-dir;%PYTHONPATH%
  jupyter notebook
  

  双击bat文件即可启动配置好的Notebook服务器。

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