推荐采用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 这类扁平结构里。原因包括：

• 随着模块增多，单个文件膨胀难定位
• 无法按功能/模块快速运行子集（如 pytest tests/api/）
• 不利于团队分工（不同人负责不同模块的测试）
• mock或fixture复用困难，容易跨模块污染

如何处理共享 fixture 和 conftest.py？

conftest.py 是pytest的配置枢纽，按作用域分层放置更安全：

• 项目级共享：放在 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/ 当成源码包导入

# python  # 工具  # 作用域  # 镜像源  # 为什么 

相关栏目： 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251813 】 【 AI营销90571 】

相关推荐： 网站建设要注意的标准 促进网站用户好感度！  如何选择可靠的免备案建站服务器？  Laravel如何使用Blade模板引擎？（完整语法和示例）  网站图片在线制作软件,怎么在图片上做链接？  php嵌入式断网后怎么恢复_php检测网络重连并恢复硬件控制【操作】  JS中使用new Date(str)创建时间对象不兼容firefox和ie的解决方法(两种)  Windows家庭版如何开启组策略(gpedit.msc)？（安装方法）  佛山网站制作系统,佛山企业变更地址网上办理步骤？  如何确认建站备案号应放置的具体位置？  Laravel Asset编译怎么配置_Laravel Vite前端构建工具使用  Windows10电脑怎么查看硬盘通电时间_Win10使用工具检测磁盘健康  如何用y主机助手快速搭建网站？  Win11怎样安装网易有道词典_Win11安装词典教程【步骤】  Win11搜索栏无法输入_解决Win11开始菜单搜索没反应问题【技巧】  Android中AutoCompleteTextView自动提示  Windows10如何删除恢复分区_Win10 Diskpart命令强制删除分区  详解Android图表 MPAndroidChart折线图  小视频制作网站有哪些,有什么看国内小视频的网站，求推荐？  canvas 画布在主流浏览器中的尺寸限制详细介绍  在线ppt制作网站有哪些软件,如何把网页的内容做成ppt？  php8.4header发送头信息失败怎么办_php8.4header函数问题解决【解答】  Microsoft Edge如何解决网页加载问题 Edge浏览器加载问题修复  大连 网站制作,大连天途有线官网？  如何快速选择适合个人网站的云服务器配置？  JS中对数组元素进行增删改移的方法总结  微信公众帐号开发教程之图文消息全攻略  高性价比服务器租赁——企业级配置与24小时运维服务  Laravel如何使用Sanctum进行API认证？（SPA实战）  如何挑选最适合建站的高性能VPS主机？  如何用狗爹虚拟主机快速搭建网站？  Laravel如何使用Laravel Vite编译前端_Laravel10以上版本前端静态资源管理【教程】  Laravel怎么实现前端Toast弹窗提示_Laravel Session闪存数据Flash传递给前端【方法】  百度输入法ai组件怎么删除 百度输入法ai组件移除工具  如何快速生成高效建站系统源代码？  如何选择PHP开源工具快速搭建网站？  Laravel怎么使用Intervention Image库处理图片上传和缩放  JavaScript如何实现路由_前端路由原理是什么  Laravel如何使用Eloquent进行子查询  详解Android——蓝牙技术 带你实现终端间数据传输  Laravel Telescope怎么调试_使用Laravel Telescope进行应用监控与调试  如何在景安服务器上快速搭建个人网站？  如何快速搭建安全的FTP站点？  如何在云指建站中生成FTP站点？  JS弹性运动实现方法分析  如何快速建站并高效导出源代码？  Android利用动画实现背景逐渐变暗  Laravel如何实现数据导出到CSV文件_Laravel原生流式输出大数据量CSV【方案】  Laravel如何使用withoutEvents方法临时禁用模型事件  车管所网站制作流程,交警当场开简易程序处罚决定书，在交警网站查询不到怎么办？  Laravel如何实现用户角色和权限系统_Laravel角色权限管理机制