推荐采用tests/顶层目录结构，镜像源码层级，如src/utils/helpers.py对应tests/utils/test_helpers.py；conftest.py按作用域分层放置，tests/下建议保留空__init__.py确保导入安全。
Python单元测试的目录结构没有强制标准，但合理的组织方式能显著提升可维护性、可读性和CI/CD集成效率。核心原则是：测试代码与被测代码分离、层级对应、命名清晰、避免循环依赖。
常见且推荐的测试目录结构
最主流、被pytest和大多数工具默认支持的是 tests/ 顶层目录方式：
- 项目根目录下新建 tests/ 文件夹（与 src/ 或 myproject/ 同级）
- tests/ 内部结构尽量镜像源码结构
- 例如源码为 src/utils/helpers.py，对应测试写在 tests/utils/test_helpers.py
- 每个测试文件以 test_ 开头，函数名也以 test_ 开头（pytest自动识别）
为什么不用 unittest.TestCase 子目录？
不建议把所有测试塞进 tests/test_something.py 这类扁平结构里。原因包括：
绿色大气办公家具类企业织梦模板1.0
下载
绿色大气办公家具类企业织梦模板是以织梦最新内核来进行开发的模板，该模板属于家具行业，装修企业，家装类，属于企业通用，装修设计、家具生产等企业均可以使用该模板，页面简洁简单，容易管理，DEDE5.5内核以上都可以使用；附带测试数据！模板特点：简洁美观大方小清新的设计风格，图片展示效果绝佳。页面结构简单，利于SEO的优化，模板后台易于管理。使用程序：织梦DEDECMS5.5以上版本都可以使用。温馨提示
- 随着模块增多，单个文件膨胀难定位
- 无法按功能/模块快速运行子集（如 pytest tests/api/）
- 不利于团队分工（不同人负责不同模块的测试）
- mock或fixture复用困难，容易跨模块污染
如何处理共享 fixture 和 conftest.py？
conftest.py 是pytest的配置枢纽，按作用域分层放置更安全：
立即学习“Python免费学习笔记（深入）”；
- 项目级共享：放在 tests/conftest.py（全局生效）
- 模块级共享：放在 tests/api/conftest.py（仅对 tests/api/ 及子目录有效）
- 避免在 src/ 中放 conftest.py —— 测试配置不应混入生产代码
- fixture 名称要有业务含义，比如 @pytest.fixture def sample_user() 而不是 obj1
是否需要 __init__.py？
从 Python 3.3+ 起，tests/ 目录本身不需要 __init__.py 就能被识别为包；但如果你在测试中用到了相对导入（比如 from ..src import mymodule），就需要它。更稳妥的做法是：
- 在 tests/ 下放空的 __init__.py（显式声明为包）
- 在 setup.py 或 pyproject.toml 中通过 packages 或 find_packages() 明确排除 tests/
- 确保 PYTHONPATH 或 -m pytest 运行方式不意外把 tests/ 当成源码包导入
