Python如何实现按模块组织测试_通过pytest文件夹结构自动化-Python教程-PHP中文网

pytest通过命名规则（test_.py或_test.py）、含__init__.py的包结构及配置文件识别测试；需确保可导入性、正确工作目录和安装方式，conftest.py作用域限于同级及子目录，命令支持路径、类、标记等精准运行。

python如何实现按模块组织测试_通过pytest文件夹结构自动化

pytest怎么识别测试文件和目录

pytest 默认只运行满足命名规则的文件和函数，不是随便放个 test_*.py 就能自动发现——它依赖明确的文件名、目录结构和可导入性。如果你把测试文件放在普通子目录里但没加 __init__.py，或者用了非标准命名（比如 check_login.py），pytest 会直接跳过。

必须以 test_ 开头或以 _test.py 结尾（如 test_utils.py 或 auth_test.py）
含测试代码的目录必须是 Python 包：存在 __init__.py（空文件即可）
目录名本身不影响识别，但嵌套过深或含特殊字符（如空格、中文）可能触发导入失败
如果项目根目录下有 pyproject.toml 或 pytest.ini，优先读取其中的 testpaths 或 python_files 配置

按模块组织时如何避免导入错误

测试文件要 import 被测模块，但路径不对就会报 ModuleNotFoundError 或 ImportError。常见错误不是写错了模块名，而是当前工作目录和 Python 路径不匹配。

推荐在项目根目录下运行 pytest，而不是进到 tests/ 目录里执行
确保被测代码在 Python path 中：可通过 sys.path.insert(0, str(Path(__file__).parent.parent)) 临时加路径，但更稳妥的是用 -m pip install -e . 安装为可编辑包
不要在测试文件里用相对导入（如 from ..src import mymodule），pytest 不支持这种语法解析
如果使用 src/ 布局（即源码全在 src/ 下），需在 pyproject.toml 中配 packages = [{include = "src"}] 并配合安装

test\_conftest.py 的作用范围和陷阱

conftest.py 是 pytest 的“配置中枢”，但它只对同级及子目录下的测试生效，不会向上影响父目录或其他分支目录。

macOS UI 自动化技能包 —— 用 Python 控制你的 Mac

让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限

下载

每个目录可放一个 conftest.py，pytest 按目录层级自动合并 fixture 和 hook
同名 fixture 在子目录 conftest.py 中定义会覆盖父目录的，不是叠加
别在 conftest.py 里写业务逻辑或耗时初始化——它会在每次测试收集阶段加载，拖慢 pytest --collect-only
如果用了 autouse=True 的 fixture，务必确认作用域（scope="session" 可能跨模块污染状态）

运行指定模块测试的常用命令写法

光靠目录结构不够，得用对命令才能精准触发对应模块的测试，否则容易误跑全量或漏掉关键路径。

跑整个模块目录：pytest tests/unit/auth/（注意结尾斜杠不是必须，但加了更明确）
跑某模块下所有测试类：pytest tests/unit/auth/test_login.py::TestLoginFlow
按标记筛选（需提前用 @pytest.mark.unit）：pytest -m unit 或 pytest -m "not integration"
想排除某个慢测试目录？用 --ignore=tests/integration/，比删文件安全

最常被忽略的一点：pytest 缓存导入状态。改了 conftest.py 或新增测试目录后，有时要加 --import-mode=importlib 才能正确重载，否则旧 fixture 还在内存里。