传递导入错误：ModuleNotFoundError：没有名为“...”的模块

Question

我现在很困惑。这是项目树：

project
- source
- - lib
- - - __init__.py
- - - utils.py
- - - stats.py
- test
- - lib
- - - test_stats.py

stats.py 有import utils，如果自己执行stats.py，它确实有效。现在test_stats.py 具有import lib.stats，但如果在project 目录中以PYTHONPATH=source pytest 执行，则会导致ModuleNotFoundError: No module named 'utils' 错误：

==================================== ERRORS ====================================
___________________ ERROR collecting test/lib/test_stats.py ___________________
ImportError while importing test module '/lib/test_stats.py'.
Hint: make sure your test modules/packages have valid Python names.
Traceback:
test/lib/test_stats.py:40: in <module>
    import lib.stats
source/lib/__init__.py:42: in <module>
    from .stats import Stats
source/lib/stats.py:40: in <module>
    import utils
E   ModuleNotFoundError: No module named 'utils'
!!!!!!!!!!!!!!!!!!! Interrupted: 1 errors during collection !!!!!!!!!!!!!!!!!!!!
=========================== 1 error in 0.19 seconds ============================

发生了什么以及如何正确执行具有这种目录结构的测试？

PS 我知道（开发模式）pip install ... 和 tox 技巧（用于模块搜索路径），但我想了解它们是否是绝对必要的或者我已经假设这个简单的设置有问题。

Answer 1

Python 3 中的import utils 是绝对导入，Python 在sys.path 中查找模块utils。

当您将stats.py 作为脚本运行时，Python 会将目录project/source/lib/ 添加到sys.path。所以脚本中的import utils 有效。

但是当您运行test_stats.py 时，Python 不会将project/source/lib/ 添加到sys.path。所以import utils 不起作用。

克服这个问题的一种方法是使用相对导入：from . import utils。在stats.py 中表示：不要搜索sys.path，从与stats.py 相同的目录导入模块utils。但是随后您失去了将stats.py 作为脚本运行的能力。因此，将主代码从 stats.py 移动到 lib/ 之外的单独脚本。

稍微不同的解决方案是将主代码从stats.py 移动到模块__main__.py 并使用python -m lib 执行模块（project/source/ 必须在sys.path 中）。