0

0

Python 单元测试设计与 pytest 实战

舞姬之光

舞姬之光

发布时间:2026-01-27 19:43:02

|

976人浏览过

|

来源于php中文网

原创

pytest自动发现测试需满足文件名(test_.py或_test.py)、函数名(test_开头)、类名(Test开头且无__init__)规则;fixture作用域选function防污染、session慎用;异常断言须用pytest.raises()上下文管理。

python 单元测试设计与 pytest 实战

pytest 是当前 Python 单元测试的事实标准,它比 unittest 更简洁、更灵活,也更容易写出可维护的测试。但直接照搬示例容易踩坑——比如测试函数名没加 test_ 前缀、fixture 作用域设错导致状态污染、或用 assert 检查异常却漏了 pytest.raises() 的上下文管理。

怎么让 pytest 自动发现并运行测试

pytest 默认只收集满足命名规则的函数和模块:文件名必须匹配 test_*.py*_test.py,函数名必须以 test_ 开头。类名也要以 Test 开头(且不能带 __init__ 方法),否则会被跳过。

常见错误现象:

  • 写了 def check_add(): —— 不会被识别
  • 文件叫 math_utils.py —— 即使里面有 test_add 也不会运行
  • 在非测试目录下执行 pytest —— 默认只搜当前目录及子目录下的测试文件

实操建议:

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

  • 统一用 test_ 前缀命名函数,如 test_add_two_positive_numbers
  • 把测试文件放在 tests/ 目录,并在项目根目录放 pyproject.toml 配置 testpaths = ["tests"]
  • 运行时显式指定路径:pytest tests/test_math.py::test_add 可精准调试单个函数

fixture 什么时候该用 function 而不是 session

fixture 的作用域(scope)直接决定它的生命周期和复用方式。用错 scope 是最隐蔽的测试污染源之一——比如数据库连接用 scope="session",但多个测试修改了同一张表,后一个测试就可能因前一个残留数据而失败。

使用场景与选择依据:

  • scope="function":默认值,每个测试函数调用前新建、结束后销毁(适合临时对象、mock、独立状态)
  • scope="class":整个测试类共用一次 setup/teardown(适合类内多个测试共享轻量初始化)
  • scope="module":一个 .py 文件内所有测试共享(适合模块级配置,如读取一次 YAML 配置)
  • scope="session":整个 pytest 运行周期只初始化一次(仅限真正全局、只读、线程安全的资源,如远程 API token)

性能影响:

PHP4 的编程与实例
PHP4 的编程与实例

前言   第一部分 入门篇   第1章 PHP简介   第2章 PHP4安装、测试与配置   第3章 PHP快速入门   第二部分 应用篇   第6章 I/O操作应用   第7章 计算应用   第8章 图像应用   第三部分 实战篇   第13章 门庭若市――网页计数器设计   第14章 不吐不快――留言板设计   第15章 它是谁――网站信息查询设计   第四部分 补充

下载
  • 过度使用 session 会让测试失去隔离性,CI 上偶发失败难复现
  • 滥用 function(比如每次创建新数据库连接)会拖慢整体执行速度,此时应考虑 module + 显式清理

如何正确断言异常和警告

直接用 assert 判断异常是否抛出是错的,因为一旦没抛出,测试就崩溃退出,无法捕获异常类型和消息;而用 try/except 又冗长且易漏掉未预期异常。

正确做法是用 pytest.raises()pytest.warns() 上下文管理器:

def test_divide_by_zero():
    with pytest.raises(ZeroDivisionError, match="division by zero"):
        1 / 0

def test_deprecated_function():
    with pytest.warns(DeprecationWarning, match="use new_api instead"):
        old_api()

关键点:

  • match 参数支持正则,比简单字符串包含更可靠
  • 不要写成 pytest.raises(ValueError) 后跟普通语句——必须用 with 包裹被测代码
  • 如果想确保「不抛异常」,直接调用即可;若需显式声明,可用 with pytest.raises(Exception): assert False,但通常没必要

参数化测试中哪些参数组合该跳过

@pytest.mark.parametrize 很方便,但不是所有输入都要测。盲目覆盖全组合会导致冗余、慢、甚至触发非目标逻辑(比如给只接受字符串的函数传 None,结果测试的是类型检查而非业务逻辑)。

推荐跳过的典型情况:

  • 明显非法但由上游校验拦截的输入(如 HTTP 视图层已用 Pydantic 验证,单元测试就不必再喂 None 给内部 service 函数)
  • 引发相同代码路径的重复值(如测试字典 key 是否存在,"a""b" 行为一致,选一个代表即可)
  • 需要复杂前置条件才能触发的边界(如“磁盘满时写入失败”,这种更适合集成测试)

实操技巧:

  • ids 参数给每组参数起可读名:ids=["empty", "single", "multi"]
  • 配合 @pytest.mark.skipif 动态跳过,比如 skipif=sys.platform == "win32"
  • 避免在 parametrize 中写复杂表达式,参数尽量是字面量或常量,否则可读性和调试性骤降

最难的从来不是写测试,而是判断哪一行逻辑值得测、哪一行只是胶水代码、以及当测试失败时,你能否三秒内分清是实现错了,还是 fixture 没 clean 干净。

热门AI工具

更多
DeepSeek
DeepSeek

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

豆包大模型
豆包大模型

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

通义千问
通义千问

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

腾讯元宝
腾讯元宝

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

文心一言
文心一言

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

讯飞写作
讯飞写作

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

即梦AI
即梦AI

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

ChatGPT
ChatGPT

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

相关专题

更多
java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

1498

2023.10.24

session失效的原因
session失效的原因

session失效的原因有会话超时、会话数量限制、会话完整性检查、服务器重启、浏览器或设备问题等等。详细介绍:1、会话超时:服务器为Session设置了一个默认的超时时间,当用户在一段时间内没有与服务器交互时,Session将自动失效;2、会话数量限制:服务器为每个用户的Session数量设置了一个限制,当用户创建的Session数量超过这个限制时,最新的会覆盖最早的等等。

315

2023.10.17

session失效解决方法
session失效解决方法

session失效通常是由于 session 的生存时间过期或者服务器关闭导致的。其解决办法:1、延长session的生存时间;2、使用持久化存储;3、使用cookie;4、异步更新session;5、使用会话管理中间件。

748

2023.10.18

cookie与session的区别
cookie与session的区别

本专题整合了cookie与session的区别和使用方法等相关内容,阅读专题下面的文章了解更详细的内容。

91

2025.08.19

登录token无效
登录token无效

登录token无效解决方法:1、检查token的有效期限,如果token已经过期,需要重新获取一个新的token;2、检查token的签名,如果签名不正确,需要重新获取一个新的token;3、检查密钥的正确性,如果密钥不正确,需要重新获取一个新的token;4、使用HTTPS协议传输token,建议使用HTTPS协议进行传输 ;5、使用双因素认证,双因素认证可以提高账户的安全性。

6142

2023.09.14

登录token无效怎么办
登录token无效怎么办

登录token无效的解决办法有检查Token是否过期、检查Token是否正确、检查Token是否被篡改、检查Token是否与用户匹配、清除缓存或Cookie、检查网络连接和服务器状态、重新登录或请求新的Token、联系技术支持或开发人员等。本专题为大家提供token相关的文章、下载、课程内容,供大家免费下载体验。

816

2023.09.14

token怎么获取
token怎么获取

获取token值的方法:1、小程序调用“wx.login()”获取 临时登录凭证code,并回传到开发者服务器;2、开发者服务器以code换取,用户唯一标识openid和会话密钥“session_key”。想了解更详细的内容,可以阅读本专题下面的文章。

1065

2023.12.21

token什么意思
token什么意思

token是一种用于表示用户权限、记录交易信息、支付虚拟货币的数字货币。可以用来在特定的网络上进行交易,用来购买或出售特定的虚拟货币,也可以用来支付特定的服务费用。想了解更多token什么意思的相关内容可以访问本专题下面的文章。

1340

2024.03.01

Python 自然语言处理(NLP)基础与实战
Python 自然语言处理(NLP)基础与实战

本专题系统讲解 Python 在自然语言处理(NLP)领域的基础方法与实战应用,涵盖文本预处理(分词、去停用词)、词性标注、命名实体识别、关键词提取、情感分析,以及常用 NLP 库(NLTK、spaCy)的核心用法。通过真实文本案例,帮助学习者掌握 使用 Python 进行文本分析与语言数据处理的完整流程,适用于内容分析、舆情监测与智能文本应用场景。

10

2026.01.27

热门下载

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

精品课程

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

共4课时 | 22.3万人学习

Django 教程
Django 教程

共28课时 | 3.6万人学习

SciPy 教程
SciPy 教程

共10课时 | 1.3万人学习

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

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