为何Python unittest指定tests模块无测试，路径方式却可执行？

场景还原 #

你的项目结构：

my-package
    my_module
        __init__.py
        ...
    tests
        __init__.py
        test_menu_csv.py
        ...

当前工作目录为~/my-package，执行不同unittest命令得到以下结果：

• python -m unittest：运行30个测试，2个失败（自动执行了my_module里的测试）
• python -m unittest tests/：报错ModuleNotFoundError: No module named 'tests/'
• python -m unittest tests/test_menu_csv.py：成功运行8个测试，结果OK
• python -m unittest tests：运行0个测试，结果OK

核心原因 #

1. python -m unittest tests为何跑0个测试？ #

unittest加载模块时，只会从指定模块中查找继承自unittest.TestCase的类，以及类里以test_开头的方法。而你的tests/__init__.py是空的，没有导入任何测试模块，所以加载tests模块时找不到可执行的测试用例，自然显示运行0个测试。

2. python -m unittest为何会执行my_module里的测试？ #

unittest的自动发现规则是：从当前工作目录开始，递归扫描所有包含__init__.py的子目录，找到所有文件名以test开头的模块，并执行其中的测试用例。如果my_module目录下存在这类测试文件，就会被自动扫描并执行。

3. python -m unittest tests/为何报错？ #

unittest命令后接的是模块名或测试类/方法名，而不是目录路径。tests/是路径格式，不是合法的Python模块名，所以会触发模块找不到的错误。

解决办法 #

方法1：修改tests/init.py导入测试模块 #

在tests/__init__.py中手动导入所有测试模块，比如：

from . import test_menu_csv
# 其他测试文件也按此格式导入

之后执行python -m unittest tests，就能加载到所有导入的测试用例并执行。

方法2：使用discover命令指定测试目录 #

直接用unittest的发现功能，限定只扫描tests目录下的测试文件：

python -m unittest discover -s tests -p "test_*.py"

参数说明：

• -s tests：指定扫描的起始目录为tests
• -p "test_*.py"：只匹配文件名以test_开头的测试文件

方法3：阻止my_module里的测试被自动发现 #

如果my_module里有不想被执行的测试文件，可通过以下方式处理：

• 给my_module里的测试文件改名，避免以test开头
• 运行python -m unittest时，用-k参数指定只执行tests里的测试（比如根据测试类名的关键词过滤）

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