pytest 的安装与验证

第 1 章：pytest 的安装与验证

📖 知识点：安装与验证

🎯 当前作用

在系统学习 pytest 之前，需要先在本地 Python 环境中安装它。一个完整的安装与验证流程能确保 pytest 正确集成到开发环境中，为后续编写和运行测试用例打下坚实基础。

🤔 使用场景

• 初次接触 pytest：首次使用时，需要在工作电脑或开发环境中完成 pytest 的安装。
• 持续集成（CI）环境：在自动化流水线（如 GitHub Actions、Jenkins）中，pytest 通常是 CI 流程的第一步，这一步的成功执行是保障整个测试流程的基础。
• 环境迁移：当你更换开发电脑或团队成员加入时，都需要在新环境中安装并验证 pytest，确保环境的一致性。

💻 案例演示

场景：新加入项目的开发/测试工程师小张，需要在自己的本地环境中安装 pytest，并验证其是否成功。

1. 安装 pytest

打开命令行终端（Terminal / CMD / PowerShell），输入以下命令：

1pip install -U pytest

💡 说明：

• pip 是 Python 的包管理工具，用于安装第三方库。
• -U 是 --upgrade 的缩写，表示如果已安装，则升级到最新版本；如果未安装，则安装最新版本。
• 你还可以使用其他包管理工具来安装，例如 conda install pytest。

2. 验证安装

安装完成后，通过查看版本号来确认 pytest 是否已正确安装：

1pytest --version

如果安装成功，终端会输出类似以下的信息：

1pytest 9.0.3

💡 说明：

• 官方文档中的安装指南明确指出可以使用 pip install -U pytest 进行安装。
• 运行 pytest --version 可以检查安装的 pytest 版本。

3. 首次运行测试

创建一个名为 test_first.py 的文件，并编写一个简单的测试函数：

1# test_first.py
2
3def add(a, b):
4    """一个简单的加法函数"""
5    return a + b
6
7def test_add():
8    """测试 add 函数"""
9    assert add(2, 3) == 5

在命令行中运行 pytest：

1pytest test_first.py -v

你将会看到如下成功的运行结果：

1============================= test session starts ==============================
2collected 1 item
3
4test_first.py::test_add PASSED                                           [100%]
5
6============================== 1 passed in 0.02s ===============================

💡 说明：

• pytest 会自动发现并运行当前目录及其子目录下所有以 test_ 开头或 _test.py 结尾的文件。
• 在测试函数中，pytest 直接使用 Python 内置的 assert 关键字来编写断言。

📚 本章小结

• pip install -U pytest：安装 pytest 的标准命令。
• pytest –version：验证安装是否成功。
• 创建 test_\*.py 文件，编写 test_\* 函数：pytest 自动发现和运行的约定规则。