Python单元测试链式导入报错：被测试模块引入依赖时找不到模块

根因说明 #

报错本质是Python模块搜索路径不匹配：启动测试脚本时，Python默认仅将测试文件所在的UnitTests目录加入sys.path，不会自动识别Scripts/Project目录，因此util2中的from util1 import add语句无法找到对应模块。

无需修改现有业务导入语句的方案 #

方案1：测试文件开头追加搜索路径 #

在测试文件最顶部添加代码，将Scripts/Project目录动态加入模块搜索路径：

import sys
import os
sys.path.append(os.path.abspath(os.path.join(os.path.dirname(__file__), "..", "Scripts", "Project")))

修改后无需调整util1、util2的导入逻辑，即可正常运行测试。

方案2：改用同目录相对导入 #

将util2中的导入语句修改为相对导入格式：

from .util1 import add

该方案不需要修改路径配置，但注意不能直接运行util2.py作为入口脚本，若需单独运行util2，需使用python -m Scripts.Project.util2命令启动。

方案3：配置PYTHONPATH环境变量 #

将Scripts/Project目录的绝对路径添加到系统PYTHONPATH环境变量中，Python全局即可识别该目录下的模块，不需要修改任何代码。

方案4：使用pytest测试框架 #

切换到pytest运行测试时，pytest会自动将执行命令的根目录（dummy_test_project）加入sys.path，只需在项目根目录下执行pytest命令即可正常运行测试，无需额外配置。

长期推荐的规范方案 #

建议将所有业务代码的导入改为从项目根目录起始的绝对导入，即from Scripts.Project.util1 import add的写法，该写法可读性和兼容性更高，不会因为执行脚本的工作目录变化出现导入失败问题。如果存量代码导入语句较多，可以写简单的正则批量替换脚本一次性处理，成本很低。

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