跨子文件夹导入Python模块报错求助：多环境路径配置问题

问题场景 #

• 初始目录结构下，Notebook与Library文件夹同级，执行from Library.some import your_function可正常导入模块
• 将Notebook移至Notebook子文件夹后，原导入语句报错Module not found: Library
• 使用Copilot提供的路径代码后，仅能通过from some import your_function导入；该方案在PyCharm中失效，而PyCharm无需额外配置即可正常使用原导入语句

核心原因 #

1. 工作目录差异：VSCode中Jupyter默认以Notebook所在目录（/Main Folder/Notebook）作为运行时工作目录，而PyCharm会自动将项目根目录（/Main Folder）加入sys.path，因此能直接识别Library作为包
2. 包结构缺失：Library文件夹若无__init__.py文件，无法被Python识别为标准包，只能通过添加文件夹路径后直接导入模块文件

解决方法 #

方法1：将Library转为标准Python包（推荐） #

1. 在Library文件夹内创建空的__init__.py文件，使其成为Python可识别的标准包
2. 在Notebook开头添加以下代码，将项目根目录加入sys.path：

import os
import sys

# 获取项目根目录路径
root_dir = os.path.abspath(os.path.join(os.getcwd(), '..'))
if root_dir not in sys.path:
    sys.path.append(root_dir)

# 恢复原导入语句即可正常使用
from Library.some import your_function

此方案兼容VSCode与PyCharm，符合Python包结构规范，便于后续代码扩展。

方法2：直接添加Library目录到sys.path（临时方案） #

若不想修改包结构，可直接将Library目录加入sys.path，但仅能直接导入模块文件：

import os
import sys

library_dir = os.path.abspath(os.path.join(os.getcwd(), '..', 'Library'))
if library_dir not in sys.path:
    sys.path.append(library_dir)

# 直接导入模块中的函数
from some import your_function

此方案仅适用于简单场景，不利于后续代码结构扩展。

方法3：配置VSCode Jupyter工作目录 #

在VSCode中打开Main Folder作为工作区，从工作区内打开Notebook文件，Jupyter会自动将项目根目录设为工作目录，无需添加路径代码即可执行from Library.some import your_function。

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