Python单元测试中多模块依赖的导入冲突解决方案咨询

嗨，这个问题确实是Python项目结构和导入机制里很常见的痛点，我来给你梳理几个靠谱的解决思路：

方案一：把项目转为可安装的包结构（长期规范方案） #

这是最推荐的长期解决方案，适合需要长期维护的项目：

1. 调整项目结构，给src目录添加包标识（新增__init__.py，也可以给包起个专属名称，比如myproject）：

├── myproject
│   ├── __init__.py
│   ├── main1.py
│   └── main2.py
├── tests
│   └── tests_main.py

2. 修改main1.py的导入为绝对导入：

from myproject import main2

def plusOne(number: int):
    return main2.addOne(number)

if __name__ == "__main__":
    print(plusOne(1))

3. 在项目根目录创建setup.py或pyproject.toml，将包注册为可安装项目，然后执行pip install -e .安装为可编辑模式。这样不管是用python -m myproject.main1运行主脚本，还是用python -m unittest tests/tests_main.py执行测试，导入逻辑都能正常工作，测试文件里的导入也改为from myproject import main1即可。

方案二：临时修改sys.path（快速临时方案） #

如果不想调整项目结构，只是临时解决测试的导入问题，可以在测试文件开头手动把src目录加入Python的模块搜索路径：

import unittest
import sys
from pathlib import Path

# 获取src目录的绝对路径并加入sys.path
src_dir = Path(__file__).parent.parent / "src"
sys.path.append(str(src_dir))

import main1

class TestMain(unittest.TestCase):
    def test_case1(self):
        number = 1
        result = main1.plusOne(number)
        self.assertEqual(result, number + 1)

if __name__ == "__main__":
    unittest.main()

这样测试时能正常找到main2模块，同时main1.py保持原来的import main2语句，直接运行python src/main1.py也不会出问题。

方案三：结合相对导入与模块运行方式 #

如果不想修改导入语句，也可以用Python的模块运行规则来启动主脚本：

1. 把main1.py的导入改为相对导入：

from . import main2

def plusOne(number: int):
    return main2.addOne(number)

if __name__ == "__main__":
    print(plusOne(1))

2. 不要直接执行python src/main1.py，而是从项目根目录用模块方式启动：python -m src.main1，这样Python会把src当作一个包，相对导入就能生效；同时测试文件里用import src.main1也能正常导入模块。

小提示 #

尽量避免在生产代码里直接修改sys.path，除非是临时调试场景。长期来看，把项目做成标准的可安装包是最能规避各类导入问题的方式，也符合Python的最佳实践。

备注：内容来源于stack exchange，提问作者joegrammer