跨项目执行测试时TextTestRunner无法识别模块的解决方法

问题原因 #

从my_project运行given_proj的测试时，Python的sys.path未包含given_proj根目录，导致测试文件无法找到package模块。而在given_proj目录下直接运行测试时，当前目录会自动加入sys.path，因此模块可以正常导入。

解决方案 #

方案1：修改sys.path添加目标项目根目录 #

将given_proj的绝对路径加入sys.path，让Python能识别package模块。修改my_project/main.py如下：

import os
import sys
import unittest

if __name__ == "__main__":
    # 获取given_proj根目录的绝对路径
    given_proj_root = os.path.abspath(os.path.join(os.path.dirname(__file__), "../given_proj"))
    # 将根目录加入sys.path最前端
    sys.path.insert(0, given_proj_root)
    # 定位到given_proj的tests目录并执行测试
    test_dir = os.path.join(given_proj_root, "tests")
    test_suite = unittest.defaultTestLoader.discover(test_dir)
    unittest.TextTestRunner().run(test_suite)

方案2：通过subprocess模拟手动运行测试 #

在given_proj目录下启动子进程执行测试命令，完全复现手动运行的环境，无需修改sys.path：

import os
import subprocess

if __name__ == "__main__":
    given_proj_root = os.path.abspath(os.path.join(os.path.dirname(__file__), "../given_proj"))
    # 在given_proj目录下执行unittest命令
    subprocess.run(
        ["python", "-m", "unittest", "discover", "-s", "tests"],
        cwd=given_proj_root,
        check=True
    )

说明 #

• 方案1适合需要在代码中处理测试结果的场景（如自定义测试报告）。
• 方案2更贴近手动运行测试的环境，避免sys.path修改带来的潜在问题，尤其适合批量处理多个项目的测试。

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