0

0

Python 测试用例目录结构设计

冷炫風刃

冷炫風刃

发布时间:2026-02-16 16:39:26

|

217人浏览过

|

来源于php中文网

原创

test/ 应与 src/ 平级——这是最稳妥的选择,可避免导入错误和 ci 不稳定;需严格遵循 pytest 命名规则(test_.py、test_函数)、路径映射(test/ 内部模仿 src/ 层级结构但不复制文件)、conftest.py 作用域规则及禁止相对导入。

python 测试用例目录结构设计

test/ 目录该不该和 src/ 平级?

绝大多数项目用 src/ 放生产代码,测试目录放哪,直接决定导入是否出错、CI 是否稳定。平级(test/src/ 同级)是最稳妥的选择——Python 的 pytest 默认从当前工作目录开始搜 test_*.py*_test.py,且能自然避开 src/ 下的包导入冲突。

常见错误现象:ModuleNotFoundError: No module named 'myapp',本质是 Python 解释器没把 src/ 加进 sys.path,而你在测试里写了 from myapp import foo

  • src/ 结构时,运行测试必须在项目根目录下执行 pytest test/,不能进到 test/ 目录里再跑
  • 别在 test/ 里写 __init__.py —— 它不是包,只是 pytest 的扫描目录
  • 如果非要用 python -m pytest,确保当前目录是项目根,否则 src/ 不会被识别为可导入源

test/ 内部要不要模仿 src/ 的包结构?

要,但只模仿层级,不复制文件。比如 src/myapp/utils.py 对应的测试放在 test/test_utils.py;若 src/myapp/api/v1/endpoints.py,测试就放 test/api/v1/test_endpoints.py。这样路径映射清晰,改一个模块时,一眼知道去哪补测试。

容易踩的坑:有人把测试文件塞进 src/myapp/tests/,结果 CI 打包时把测试代码一起打进 wheel,体积变大,还可能触发误导入。

立即学习Python免费学习笔记(深入)”;

magento(麦进斗)
magento(麦进斗)

Magento是一套专业开源的PHP电子商务系统。Magento设计得非常灵活,具有模块化架构体系和丰富的功能。易于与第三方应用系统无缝集成。Magento开源网店系统的特点主要分以下几大类,网站管理促销和工具国际化支持SEO搜索引擎优化结账方式运输快递支付方式客户服务用户帐户目录管理目录浏览产品展示分析和报表Magento 1.6 主要包含以下新特性:•持久性购物 - 为不同的

下载
  • 测试目录结构只服务于人眼定位和工具扫描,pytest 不依赖它做导入解析
  • 不要求每个 .py 都有对应测试文件,空目录(如 test/api/v2/)可以存在,只要没 test_*.py,pytest 就忽略
  • 避免在测试文件里用相对导入(如 from ..utils import helper),它依赖运行时的 __package__,极易崩

conftest.py 放哪?为什么不能乱放?

conftest.py 是 pytest 的配置钩子文件,作用域由它所在目录决定:放在 test/ 根下,整个测试套件都可见;放在 test/api/ 下,就只对 test/api/** 里的测试生效。放错位置,fixture 就找不到,或者意外覆盖。

典型错误现象:Fixture 'db_session' not found,查半天发现 conftest.pytest/unit/,但测试跑在 test/integration/,压根没加载。

  • 全局 fixture(如 tmp_path 增强、日志捕获)统一放 test/conftest.py
  • 模块级 fixture(如某组 API 共用的 mock server)放在对应子目录的 conftest.py,别往上提
  • 一个目录下最多一个 conftest.py,重复会导致 pytest 加载失败或行为不可预测

测试文件命名和函数名怎么起才不被 pytest 忽略?

pytest 只认两种默认模式:test_*.py*_test.py;函数名必须是 test_* 开头。名字不对,文件就静默跳过,连报错都没有,最危险。

常见错误现象:写了 check_login_flow.py,里面函数叫 verify_login(),运行 pytest 后显示 0 tests collected,人傻了。

  • 文件名必须含 test 前缀或后缀,推荐统一用 test_*.py(更符合直觉)
  • 函数名必须是 test_ 开头,后面接描述性名字,如 test_user_creation_with_valid_email,别缩写成 test_create_user —— 模糊的命名会让失败时多花三倍时间定位
  • 类名也得是 Test* 开头,且不能带 __init__ 方法,否则 pytest 会跳过整个类

路径映射和命名规则看着琐碎,但一旦定下来,后续加新模块、配 CI、交接给同事,几乎不用再想“测试该放哪儿”。真正麻烦的是早期图省事随便放,等项目长到二十个模块,重构测试结构比重写部分业务还累。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法
pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法

本专题系统整理pixiv网页版官网入口及登录访问方式,涵盖官网登录页面直达路径、在线阅读入口及快速进入方法说明,帮助用户高效找到pixiv官方网站,实现便捷、安全的网页端浏览与账号登录体验。

145

2026.02.13

微博网页版主页入口与登录指南_官方网页端快速访问方法
微博网页版主页入口与登录指南_官方网页端快速访问方法

本专题系统整理微博网页版官方入口及网页端登录方式,涵盖首页直达地址、账号登录流程与常见访问问题说明,帮助用户快速找到微博官网主页,实现便捷、安全的网页端登录与内容浏览体验。

100

2026.02.13

Flutter跨平台开发与状态管理实战
Flutter跨平台开发与状态管理实战

本专题围绕Flutter框架展开,系统讲解跨平台UI构建原理与状态管理方案。内容涵盖Widget生命周期、路由管理、Provider与Bloc状态管理模式、网络请求封装及性能优化技巧。通过实战项目演示,帮助开发者构建流畅、可维护的跨平台移动应用。

34

2026.02.13

TypeScript工程化开发与Vite构建优化实践
TypeScript工程化开发与Vite构建优化实践

本专题面向前端开发者,深入讲解 TypeScript 类型系统与大型项目结构设计方法,并结合 Vite 构建工具优化前端工程化流程。内容包括模块化设计、类型声明管理、代码分割、热更新原理以及构建性能调优。通过完整项目示例,帮助开发者提升代码可维护性与开发效率。

13

2026.02.13

Redis高可用架构与分布式缓存实战
Redis高可用架构与分布式缓存实战

本专题围绕 Redis 在高并发系统中的应用展开,系统讲解主从复制、哨兵机制、Cluster 集群模式及数据分片原理。内容涵盖缓存穿透与雪崩解决方案、分布式锁实现、热点数据优化及持久化策略。通过真实业务场景演示,帮助开发者构建高可用、可扩展的分布式缓存系统。

19

2026.02.13

c语言 数据类型
c语言 数据类型

本专题整合了c语言数据类型相关内容,阅读专题下面的文章了解更多详细内容。

27

2026.02.12

雨课堂网页版登录入口与使用指南_官方在线教学平台访问方法
雨课堂网页版登录入口与使用指南_官方在线教学平台访问方法

本专题系统整理雨课堂网页版官方入口及在线登录方式,涵盖账号登录流程、官方直连入口及平台访问方法说明,帮助师生用户快速进入雨课堂在线教学平台,实现便捷、高效的课程学习与教学管理体验。

11

2026.02.12

豆包AI网页版入口与智能创作指南_官方在线写作与图片生成使用方法
豆包AI网页版入口与智能创作指南_官方在线写作与图片生成使用方法

本专题汇总豆包AI官方网页版入口及在线使用方式,涵盖智能写作工具、图片生成体验入口和官网登录方法,帮助用户快速直达豆包AI平台,高效完成文本创作与AI生图任务,实现便捷智能创作体验。

371

2026.02.12

PostgreSQL性能优化与索引调优实战
PostgreSQL性能优化与索引调优实战

本专题面向后端开发与数据库工程师,深入讲解 PostgreSQL 查询优化原理与索引机制。内容包括执行计划分析、常见索引类型对比、慢查询优化策略、事务隔离级别以及高并发场景下的性能调优技巧。通过实战案例解析,帮助开发者提升数据库响应速度与系统稳定性。

28

2026.02.12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
最新Python教程 从入门到精通
最新Python教程 从入门到精通

共4课时 | 22.4万人学习

Django 教程
Django 教程

共28课时 | 4.3万人学习

SciPy 教程
SciPy 教程

共10课时 | 1.6万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号