pytest+requests+allure安装配置

pytest + requests + allure 是 Python 接口自动化测试的黄金组合。下面按 Python 库安装 和 Allure 命令行工具安装 两部分来说明。

---

一、整体安装概览

 

组件	安装方式	说明
requests	pip install requests	Python 库
pytest	pip install pytest	Python 库
allure-pytest	pip install allure-pytest	pytest 和 allure 的集成插件
Allure 命令行工具	下载安装包 + 配置环境变量	独立工具，用于生成 HTML 报告

---

二、安装 Python 库

在命令行（或 在 PyCharm 窗口的底部工具栏，你会看到一个 Terminal 标签页。直接点击它就可以打开。）中依次执行：

bash

# 安装 requests - 发送 HTTP 请求
pip install requests

# 安装 pytest - 测试框架
pip install pytest

# 安装 allure-pytest - 让 pytest 能和 allure 配合生成报告数据
pip install allure-pytest

也可以一次性安装：

bash

pip install requests pytest allure-pytest
[citation:1][citation:3][citation:6]

验证安装是否成功：

bash

pip list | findstr "requests pytest allure"

如果能找到这三个包，说明 Python 库部分安装完成。

---

三、安装 Allure 命令行工具（关键步骤）

Allure 分为两部分：

• allure-pytest：Python 插件，负责在运行测试时生成原始数据（JSON/XML 文件）

• Allure 命令行工具：负责把原始数据转换成漂亮的 HTML 报告

我们接下来安装的是命令行工具。

Windows 安装步骤

1. 安装 JDK（Java 环境）

Allure 依赖 Java 运行环境。如果没有安装 JDK，先安装：

• 下载 JDK 11 或更高版本：https://www.oracle.com/java/technologies/downloads/

• 安装后，配置 JAVA_HOME 环境变量，并将 %JAVA_HOME%\bin 加入 Path

• 验证：java -version

2. 下载 Allure 命令行工具

• 下载地址：https://repo.maven.apache.org/maven2/io/qameta/allure/allure-commandline/

• 选择最新版本，下载 .zip 文件 

3. 解压并配置环境变量

• 将下载的 .zip 解压到指定目录，例如 D:\allure-commandline

• 进入 D:\allure-commandline\bin 目录，记住这个路径（里面有 allure.bat 文件）

• 将 D:\allure-commandline\bin 添加到系统环境变量 Path 中 

添加环境变量步骤：

• 右键"此电脑" → 属性 → 高级系统设置 → 环境变量

• 在"系统变量"中找到 Path，双击编辑

• 点击"新建"，粘贴 D:\allure-commandline\bin（改成你自己的实际路径）

• 点击"确定"保存

4. 验证安装

重启命令行窗口（重要，环境变量需要刷新），然后输入：

bash

allure --version

如果显示版本号（如 2.32.0），说明安装成功。

---

四、完整安装检查清单

 

检查项	验证命令	预期结果
requests 库	pip show requests	显示版本信息
pytest 库	pip show pytest	显示版本信息
allure-pytest	pip show allure-pytest	显示版本信息
Allure 命令行	allure --version	显示版本号，如 2.32.0
JDK	java -version	显示 Java 版本

---

五、一个简单的测试来验证

创建一个测试文件 test_demo.py：

python

import requests
import allure
import pytest

@allure.feature("示例功能")
class TestDemo:
    
    @allure.story("测试百度访问")
    def test_baidu(self):
        response = requests.get("https://www.baidu.com")
        assert response.status_code == 200
        allure.attach("访问百度成功", "结果", allure.attachment_type.TEXT)

运行测试并生成报告：

打开 PyCharm 底部的 Terminal 终端（如果找不到，可以按 Alt + F12 快捷键）

然后依次输入以下两条命令：
注意：如果你终端窗口中当前的目录中不是你要运行的py文件的目录，你需要先进入到要运行的py文件所在目录，再执行下面命令

bash

# 第1条命令：运行测试，生成 allure 数据
pytest test_demo.py --alluredir=allure-results

运行成功后，你会看到类似这样的输出：

text

============================= test session starts =============================
collected 1 item

test_demo.py .                                                            [100%]

============================== 1 passed in 0.15s ==============================

然后继续输入第2条命令：

bash

# 第2条命令：生成并打开 HTML 报告
allure serve allure-results

执行后，浏览器会自动打开一个漂亮的测试报告页面。

---

六、常见问题

 

问题	解决方法
allure 不是内部或外部命令	检查环境变量是否配置正确，配置后重启命令行
java 不是内部或外部命令	需要先安装 JDK 并配置 JAVA_HOME
pip 安装慢	使用清华源：pip install -i https://pypi.tuna.tsinghua.edu.cn/simple requests pytest allure-pytest