Azure Jupyter Notebook生产就绪改造：相对路径基准设置问题解决方案咨询

这个问题在Jupyter/Azure Notebook场景下非常典型——当用%run从主Notebook调用子Notebook时，Python的工作目录（CWD）会保持在主Notebook所在的位置，导致子Notebook里的相对路径全部以主文件为基准，而非自身所在目录。下面是几个可行的解决方案：

方案1：基于项目根目录使用绝对路径（生产就绪首选） #

这是最稳妥的生产级方案，完全规避相对路径的不确定性。核心思路是定义一个项目根目录常量，所有文件引用都基于这个根目录构建绝对路径。

具体步骤： #

1. 在root/main.ipynb中定义项目根目录：

   import os
   from pathlib import Path
   
   # 直接将当前工作目录（main.ipynb所在的root）设为项目根
   PROJECT_ROOT = Path(os.getcwd())
   
   # 用绝对路径运行code01.ipynb
   get_ipython().run_line_magic('run', str(PROJECT_ROOT / "file01/code01.ipynb"))
   

2. 修改root/file01/code01.ipynb中的路径引用：

   # 直接基于项目根构建parameters.ipynb的绝对路径
   params_path = PROJECT_ROOT / "param/parameters.ipynb"
   get_ipython().run_line_magic('run', str(params_path))
   

优点： #

• 路径完全可控，无论从哪个文件调用，都不会出现路径错误
• 符合生产环境的代码规范，可读性和可维护性强

方案2：临时切换工作目录到子Notebook所在位置 #

通过临时切换工作目录，让子Notebook里的相对路径恢复正常，运行完成后再切回原目录。

具体修改（在root/file01/code01.ipynb开头添加）： #

import os
from pathlib import Path

# 保存原始工作目录
original_cwd = os.getcwd()

# 切换到当前Notebook所在的目录
current_notebook_dir = Path(os.getcwd()) / "file01"
os.chdir(current_notebook_dir)

# 现在可以正常使用相对路径了
get_ipython().run_line_magic('run', '../param/parameters.ipynb')

# 运行完成后切回原工作目录，避免影响后续代码
os.chdir(original_cwd)

优点： #

• 不需要修改原有的相对路径写法
• 不需要依赖第三方库

缺点： #

• 硬编码了子Notebook的目录结构，如果后续文件夹重命名或移动，需要手动修改代码

方案3：获取子Notebook的绝对路径（依赖第三方库） #

使用ipynbname库获取当前运行的Notebook的绝对路径，然后基于这个路径构建相对文件的引用，不需要硬编码目录结构。

具体步骤： #

1. 先安装依赖库：

   !pip install ipynbname
   

2. 修改root/file01/code01.ipynb：

   import ipynbname
   from pathlib import Path
   
   # 获取当前Notebook的绝对路径
   current_notebook_path = ipynbname.path()
   # 获取Notebook所在的目录
   current_notebook_dir = current_notebook_path.parent
   
   # 基于当前目录构建parameters.ipynb的路径
   params_path = current_notebook_dir / "../param/parameters.ipynb"
   # 解析为绝对路径后运行
   get_ipython().run_line_magic('run', str(params_path.resolve()))
   

优点： #

• 不需要硬编码目录结构，文件夹移动后代码自动适配
• 保留了相对路径的写法逻辑

缺点： #

• 依赖第三方库，需要额外安装，对于严格的生产环境可能需要评估依赖风险

如果你正在将Notebook改造为生产就绪状态，方案1绝对是最佳选择——它的路径逻辑清晰，完全避免了相对路径带来的不确定性，也符合生产代码的规范。

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