Python跨文件夹导入类失效：src结构下原正常导入语句突然报错

这种原导入语句突然失效的核心原因几乎都是Python模块搜索路径中缺失了src的父目录，可按以下步骤排查修复：

第一步：验证根因 #

在d2d_interactions_predictions.py的最开头插入以下代码，运行后查看输出：

import sys
print(sys.path)

如果输出列表中没有src所在的上层文件夹的绝对路径，即可确认是模块搜索路径配置丢失导致的问题。

第二步：选择对应修复方案 #

方案1：运行时指定Python路径 #

适合直接用命令行运行脚本的场景，运行命令前先把项目根目录（src所在的文件夹）加入Python路径：

# Linux/macOS 示例，替换为你自己的项目根目录路径
PYTHONPATH=/path/to/your/project_root python src/main/d2d_interactions/d2d_interactions_predictions.py

# Windows cmd 示例
set PYTHONPATH=C:\path\to\your\project_root && python src\main\d2d_interactions\d2d_interactions_predictions.py

# Windows PowerShell 示例
$env:PYTHONPATH = "C:\path\to\your\project_root"; python src\main\d2d_interactions\d2d_interactions_predictions.py

方案2：代码内动态添加搜索路径 #

无需修改运行命令，直接在导入语句前添加路径配置代码：

import sys
from pathlib import Path

# __file__为当前脚本的路径，.parent层数可根据实际目录结构调整，最终指向src的父目录即可
sys.path.append(str(Path(__file__).parent.parent.parent.parent.resolve()))

# 原有导入语句可正常使用
from src.data_readers.d2d_releases_reader import d2d_releases_reader

层数说明：1次.parent到d2d_interactions文件夹，2次到main文件夹，3次到src文件夹，4次到项目根目录。

方案3：修复IDE配置 #

如果是用PyCharm、VSCode等IDE运行，大概率是之前的源根配置丢失：

• PyCharm：右键点击项目根目录（src所在的文件夹）→ 选择Mark Directory as → 勾选Sources Root
• VSCode：在项目.vscode/settings.json中添加配置：

"python.analysis.extraPaths": ["${workspaceFolder}"]

方案4：改用相对导入 #

不依赖搜索路径配置的方案，修改导入语句为：

from ...data_readers.d2d_releases_reader import d2d_releases_reader

注意该方式不能直接运行当前脚本，需要以模块方式启动：

python -m src.main.d2d_interactions.d2d_interactions_predictions

其他排查点 #

• 检查是否最近切换了虚拟环境，新环境没有对应路径配置
• 检查各级目录下的__init__.py是否被误删
• 检查文件名、类名的大小写是否有误，不同操作系统对大小写敏感度不同

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