问题：重叠的sys.path条目

当sys.path条目重叠时，即具有相同的模块名称的重复导入发生：也就是说，当同时sys.path包含父目录和子目录作为单独的条目时。这种情况几乎总是一个错误：它将使Python将子目录视为一个单独的，不相关的导入根目录，这会导致令人惊讶的行为。

在你的示例中：

$ python -m unittest discover src/namespace/
namespace.testcase.a
testcase.sub.b
testcase.a

这意味着src和都src/namespace以结束sys.path，因此：

• namespace.testcase.a是相对于导入的src
• testcase.sub.b和testcase.a相对于导入src/namespace

为什么？

在这种情况下，sys.path发生重叠的条目是因为unittest discover想提供帮助：默认情况下，假设测试发现的起始目录也是你导入所相对的顶层目录，并将该顶层目录插入到目录中。sys.path（如果还没有的话），为方便起见。（…事实证明不太方便。😔️）

解决方案：明确指定正确的顶层目录

你可以使用-t（--top-level-directory）显式指定正确的顶层目录：

python -m unittest discover -t src -s src/namespace/

这将像以前一样工作，但不会src/namespace作为要插入的顶级目录sys.path。

旁注：的-s选项前缀src/namespace/在上一个示例中是隐式的：上面的示例使它明确。（unittest discover具有怪异位置参数处理：它把它的前三个位置参数作为数值-s，-p以及-t，以该顺序）。

细节

负责此工作的代码位于unittest / loader.py中：

class TestLoader(object):

    def discover(self, start_dir, pattern='test*.py', top_level_dir=None):

        ...

        if top_level_dir is None:
            set_implicit_top = True
            top_level_dir = start_dir

        top_level_dir = os.path.abspath(top_level_dir)

        if not top_level_dir in sys.path:
            # all test modules must be importable from the top level directory
            # should we *unconditionally* put the start directory in first
            # in sys.path to minimise likelihood of conflicts between installed
            # modules and development versions?
            sys.path.insert(0, top_level_dir)

        ...