Python3.12弃用unittest，pytest重构教程

Python 3.12正式废弃了unittest.TestCase.runTest方法，触发DeprecationWarning并预告未来彻底移除，标志着传统动态测试模式（如基于runTest的参数化或框架封装）已不再被官方支持；本文直击痛点，提供从unittest到pytest平滑迁移的实战指南——无需继承、去掉self、用原生assert替代断言方法，同时详解setUp/tearDown、参数化、跳过、异常捕获等关键场景的对应转换方案，并提醒pytest.ini配置、文件命名约定、fixture重构及覆盖率工具兼容性等易忽略却至关重要的细节，助你高效拥抱更简洁、灵活、可持续的现代测试实践。

为什么unittest.TestCase.runTest在Python 3.12里报DeprecationWarning

Python 3.12正式废弃了unittest.TestCase.runTest方法——它曾被用来动态定义测试逻辑（比如在基类中重写runTest再通过TestCase(methodName='runTest')构造实例）。现在调用会触发DeprecationWarning: TestCase.runTest() is deprecated，且未来版本会直接移除。

这不是误报，而是CPython明确标记的废弃路径。如果你的项目还依赖这种写法（常见于老式参数化测试、动态测试生成或某些测试框架封装层），升级到3.12后必须改。

直接替换为pytest是更可持续的选择：它不依赖TestCase类结构，天然支持函数式测试和灵活参数化，也避免了这类API生命周期绑定问题。

把unittest.TestCase子类快速转成pytest函数

核心原则：丢掉继承、去掉self、把assert*换成原生assert语句。pytest能自动识别test_*命名的函数，并处理断言失败时的详细输出（包括变量值展开）。

• 删掉import unittest和class TestFoo(unittest.TestCase):声明
• 把每个def test_something(self):改成def test_something():（无参数）
• 把self.assertEqual(a, b)换成assert a == b；self.assertIn(x, y) → assert x in y
• 若原测试用了setUp/tearDown，改用@pytest.fixture作用域控制，或直接内联初始化/清理逻辑

示例：

# 旧 unittest 写法
class TestCalc(unittest.TestCase):
    def setUp(self):
        self.calc = Calculator()
    def test_add(self):
        self.assertEqual(self.calc.add(2, 3), 5)

# 新 pytest 写法
def test_add():
    calc = Calculator()
    assert calc.add(2, 3) == 5

处理unittest特有模式：参数化、跳过、预期异常

pytest原生支持这些，但语法和行为有差异，容易踩坑：

• @unittest.skip → 改用@pytest.mark.skip或@pytest.mark.skipif(condition)；注意reason参数名不变，但必须显式传参，不能省略
• 参数化：unittest靠subTest或第三方库，而pytest用@pytest.mark.parametrize("a,b,expected", [(1,2,3), (0,0,0)])，参数名必须与函数签名严格匹配
• 预期异常：with self.assertRaises(ValueError): → with pytest.raises(ValueError):；但pytest.raises默认不捕获BaseException子类（如SystemExit），需显式加match=或用pytest.raises(..., match=r"xxx")校验消息

特别注意：subTest在pytest里没有直接等价物——它本质是unittest的“嵌套测试报告”机制，pytest靠参数化+清晰的用例命名替代，不需要模拟嵌套。

运行和兼容性：别漏掉pytest.ini和conftest.py

直接跑pytest命令可能因默认配置导致行为变化：

• 默认不收集*_test.py或test_*.py以外的文件，确认你的测试文件名符合约定；否则在pytest.ini里加python_files = *_test.py test_*.py mytests.py
• 如果有全局fixture（比如DB连接、mock配置），别放在unittest的setUpClass里，统一移到conftest.py中用@pytest.fixture(scope="session")
• pytest默认开启--tb=short，但若你依赖完整traceback（比如CI日志分析），加--tb=long到addopts

迁移后务必验证覆盖率工具是否仍能识别新测试——有些旧版coverage.py对pytest支持不全，建议升级到6.0+并检查pyproject.toml中[tool.coverage.run]的source和omit配置是否覆盖新路径。

最易忽略的是隐式依赖unittest内部状态的代码，比如手动调用TestCase.__init__或修改_outcome属性。这类代码必须重写，pytest不提供对应钩子，强行兼容只会拖慢迁移节奏。

本篇关于《Python3.12弃用unittest，pytest重构教程》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！