Pytest教程： Pytest ini配置文件深度剖析

一、Pytest配置体系认知：为什么ini文件如此重要？

[1.1 配置方式优先级排序](#1.1 配置方式优先级排序)

[1.2 常见ini配置文件对比](#1.2 常见ini配置文件对比)

二、pytest.ini基础：文件结构与创建规范

[2.1 基本结构解析](#2.1 基本结构解析)

[2.2 文件创建与放置位置](#2.2 文件创建与放置位置)

[2.3 验证配置是否生效](#2.3 验证配置是否生效)

三、核心配置项深度解析

[3.1 用例发现规则配置：定义"哪些是用例"](#3.1 用例发现规则配置：定义“哪些是用例”)

[3.1.1 testpaths：指定用例根目录](#3.1.1 testpaths：指定用例根目录)

[3.1.2 python_files：自定义用例文件命名规则](#3.1.2 python_files：自定义用例文件命名规则)

[3.1.3 python_classes：自定义用例类命名规则](#3.1.3 python_classes：自定义用例类命名规则)

[3.1.4 python_functions：自定义用例方法命名规则](#3.1.4 python_functions：自定义用例方法命名规则)

[3.2 运行参数配置：控制用例执行的行为](#3.2 运行参数配置：控制用例执行的行为)

[3.2.1 addopts：批量设置运行参数](#3.2.1 addopts：批量设置运行参数)

[3.2.2 标记相关配置：管理用例标记](#3.2.2 标记相关配置：管理用例标记)

[3.3 日志配置：规范化用例运行日志](#3.3 日志配置：规范化用例运行日志)

[3.4 报告配置：生成专业的测试报告](#3.4 报告配置：生成专业的测试报告)

[3.4.1 HTML报告配置（pytest-html）](#3.4.1 HTML报告配置（pytest-html）)

[3.4.2 Allure报告配置（pytest-allure-adaptor）](#3.4.2 Allure报告配置（pytest-allure-adaptor）)

[3.5 环境变量与路径配置：适配不同运行环境](#3.5 环境变量与路径配置：适配不同运行环境)

[3.5.1 pythonpath：添加模块搜索路径](#3.5.1 pythonpath：添加模块搜索路径)

[3.5.2 env：配置环境变量](#3.5.2 env：配置环境变量)

[3.6 插件配置：扩展Pytest功能](#3.6 插件配置：扩展Pytest功能)

[3.6.1 plugins：指定加载的插件](#3.6.1 plugins：指定加载的插件)

[3.6.2 常用插件推荐](#3.6.2 常用插件推荐)

四、实战场景，打造复杂Pytest配置方案

[4.1 项目目录结构设计](#4.1 项目目录结构设计)

[4.2 完整pytest.ini配置方案](#4.2 完整pytest.ini配置方案)

[4.3 配置使用技巧](#4.3 配置使用技巧)

五、配置优化与问题排查

[5.1 配置优化技巧](#5.1 配置优化技巧)

[5.2 常见问题排查方法](#5.2 常见问题排查方法)

[5.2.1 配置不生效问题](#5.2.1 配置不生效问题)

[5.2.2 插件加载失败问题](#5.2.2 插件加载失败问题)

[5.2.3 用例识别失败问题](#5.2.3 用例识别失败问题)

Pytest的灵活性很大程度上得益于其配置系统，其中ini配置文件（尤其是pytest.ini）作为最核心的配置载体，承担着用例发现规则定义、运行参数设置、插件配置等关键职责。掌握ini配置文件的使用技巧，能让我们的测试工作更高效、更规范。本文将从基础概念出发，逐步深入ini配置文件的核心配置项、实战场景应用、进阶技巧及问题排查，带大家全方位解锁Pytest ini配置的奥秘。

一、Pytest配置体系认知：为什么ini文件如此重要？

在深入ini配置文件之前，我们首先要明确Pytest的配置体系结构，理解ini文件在其中的定位。Pytest支持多种配置方式，包括命令行参数、ini配置文件、conftest.py文件、 pytest.ini、 tox.ini、 setup.cfg等，不同配置方式有着不同的优先级和适用场景。

1.1 配置方式优先级排序

Pytest加载配置时遵循"就近原则"和"特异性原则"，优先级从高到低依次为：

命令行参数（如pytest -v -s）：临时指定，仅对当前运行有效，灵活性最高但无法复用。
conftest.py文件：局部配置，可实现用例共享、钩子函数定义等，作用域为所在目录及子目录。
ini配置文件（pytest.ini > tox.ini > setup.cfg）：全局配置，定义通用运行规则，可复用性强，是团队协作的核心配置载体。
Pytest默认配置：无任何自定义配置时，使用框架内置规则（如用例文件以test_开头、用例函数以test_开头等）。

从优先级可以看出，ini配置文件是平衡"通用性"和"可配置性"的最佳选择，尤其适合团队统一测试规范。

1.2 常见ini配置文件对比

Pytest支持解析多种ini格式的配置文件，核心区别在于命名和适用场景：

pytest.ini：Pytest专属配置文件，优先级最高，支持所有Pytest配置项，推荐作为首选配置文件。
tox.ini：主要用于tox自动化测试环境管理，同时支持Pytest配置，适合需要结合tox使用的场景。
setup.cfg：Python项目的安装配置文件，可嵌入Pytest配置，适合简单项目或需要统一项目配置的场景，但部分高级配置项不支持。

二、pytest.ini基础：文件结构与创建规范

pytest.ini是一个标准的INI格式文件，由"节（Section）"和"键值对（Key-Value）"组成，结构简洁且易于维护。

2.1 基本结构解析

一个完整的pytest.ini文件通常包含多个节，每个节对应一类配置功能，核心结构如下：

python 复制代码

[pytest]
; 核心配置项：用例发现规则、运行参数等
testpaths = tests
python_files = test_*.py
python_classes = Test*
python_functions = test_*

; 日志配置
log_level = INFO
log_format = %(asctime)s - %(name)s - %(levelname)s - %(message)s
log_date_format = %Y-%m-%d %H:%M:%S

; 报告配置
addopts = --html=report/report.html --self-contained-html

; 插件配置
plugins =
    pytest-html
    pytest-rerunfailures

各部分说明：

节标识 ：以[节名]开头，如[pytest]是Pytest的核心配置节，所有Pytest相关的配置项均在此节下。
注释：以;开头，用于说明配置项的含义，不影响配置生效，建议多写注释提高可读性。
键值对 ：格式为键=值，值可以是字符串、列表等类型，部分配置项支持多值（以空格分隔或换行列举）。

2.2 文件创建与放置位置

pytest.ini的创建和放置有严格规范，否则Pytest无法识别：

命名要求 ：必须严格命名为pytest.ini，大小写敏感（Windows系统不敏感，Linux/Mac系统敏感），不可修改为其他名称（如pytest_config.ini）。
放置位置：推荐放置在项目的根目录下，此时配置作用域为整个项目；若放置在子目录下，仅对该子目录及子目录下的用例生效（但不推荐此用法，易造成配置混乱）。
编码格式：建议使用UTF-8编码，避免中文注释或配置值出现乱码问题。

2.3 验证配置是否生效

创建pytest.ini后，需验证配置是否被Pytest正确识别，常用方法有两种：

命令行验证 ：执行pytest --help命令，在输出结果的"INI options"部分可查看当前生效的ini配置项。
运行日志验证 ：执行用例时添加-v参数（详细模式），Pytest会在日志中输出"using: pytest.ini"，并显示关键配置项（如用例目录、命名规则等）。

三、核心配置项深度解析

[pytest]节是pytest.ini的核心，包含了用例发现、运行参数、日志、报告等各类配置项。本节将按功能分类，逐一讲解核心配置项的用法、参数及实战场景。

3.1 用例发现规则配置：定义"哪些是用例"

Pytest默认通过命名规则识别用例，但实际项目中可能需要自定义规则（如用例文件以case_开头），此时需通过以下配置项实现：

3.1.1 testpaths：指定用例根目录

作用：定义Pytest查找用例的根目录，默认值为当前运行命令的目录（即.）。

语法：testpaths = 目录1 目录2 ...（多目录以空格分隔）

实战示例：

python 复制代码

[pytest]
; 指定用例放在tests和cases两个目录下
testpaths = tests cases

说明：Pytest会递归查找testpaths指定目录下的所有符合命名规则的用例文件，无需手动指定子目录。

3.1.2 python_files：自定义用例文件命名规则

作用：定义哪些.py文件会被识别为用例文件，默认值为test_*.py。

语法：支持通配符*（匹配任意字符）和?（匹配单个字符），多规则以空格分隔。

实战示例：

python 复制代码

[pytest]
; 识别以test_开头或case_开头的文件为用例文件
python_files = test_*.py case_*.py

说明：配置后，test_login.py和case_pay.py会被识别为用例文件，而login.py则不会。

3.1.3 python_classes：自定义用例类命名规则

作用：定义用例文件中哪些类会被识别为用例类，默认值为Test*。

语法：同python_files，支持通配符和多规则。

实战示例：

python 复制代码

[pytest]
; 识别以Test或Case开头的类为用例类
python_classes = Test* Case*

注意：用例类中必须包含用例方法，且类不能有__init__构造函数（否则Pytest无法实例化）。

3.1.4 python_functions：自定义用例方法命名规则

作用：定义用例类或模块中哪些函数会被识别为用例方法，默认值为test_*。

语法：支持通配符和多规则，同时支持排除规则（以!开头）。

实战示例：

python 复制代码

[pytest]
; 识别以test_开头或case_开头的函数为用例，排除以test_skip开头的函数
python_functions = test_*.py case_* !test_skip*

说明：配置后，test_login()和case_pay()会被识别为用例，而test_skip_logout()则会被排除。

3.2 运行参数配置：控制用例执行的行为

除了用例发现规则，我们还需要控制用例的运行行为（如显示详细日志、跳过某些用例等），核心配置项为addopts，它相当于命令行参数的"永久化"。

3.2.1 addopts：批量设置运行参数

作用：将常用的命令行参数写入配置文件，每次运行Pytest时自动生效，无需重复输入。

语法：addopts = 参数1 参数2 ...（参数与命令行参数一致）

常用参数及实战示例：

python 复制代码

[pytest]
; 1. 基础参数：详细模式+显示打印信息+停止于第一个失败
; addopts = -v -s -x

; 2. 报告参数：生成HTML报告+独立文件（无需依赖外部资源）
; addopts = --html=reports/pytest_report.html --self-contained-html

; 3. 重试参数：失败用例重试2次（需安装pytest-rerunfailures插件）
; addopts = --reruns 2 --reruns-delay 1

; 4. 过滤参数：只运行标记为smoke的用例（需结合@pytest.mark.smoke装饰器）
; addopts = -m smoke

; 5. 综合参数：常用参数组合
addopts = -v -s --html=reports/report.html --self-contained-html --reruns 2 -m smoke

参数说明：

-v：详细模式，显示用例执行的详细信息（如用例路径、执行结果）。
-s：显示用例中的打印信息（如print语句），默认情况下Pytest会捕获打印信息。
-x：停止于第一个失败的用例，适合快速定位问题。
--reruns n：失败用例重试n次，需安装插件pytest-rerunfailures。
-m 标记名：只运行带有指定标记的用例，需结合@pytest.mark.标记名装饰器。

3.2.2 标记相关配置：管理用例标记

当使用-m参数标记用例时，Pytest会默认警告"未注册的标记"，需通过以下配置项注册标记，消除警告并统一管理标记。

markers：注册用例标记作用：注册自定义标记，避免运行时出现警告，同时可添加标记说明。实战示例：

python 复制代码

[pytest]
; 注册smoke（冒烟测试）、regression（回归测试）标记，并添加说明
markers =
    smoke: 冒烟测试用例，覆盖核心功能
    regression: 回归测试用例，覆盖全量功能
    pay: 支付相关用例，需特殊环境使用方式：在测试用例中通过装饰器使用标记：import pytest

@pytest.mark.smoke
def test_login():
    assert "success" in login("admin", "123456")

@pytest.mark.pay
def test_pay():
    assert pay(100) == "success"

norecursedirs：排除不需要递归的目录作用：指定Pytest不需要递归查找用例的目录，避免加载无关文件（如venv、logs目录）。

python 复制代码

[pytest]
testpaths = tests
; 排除venv、logs、reports目录
norecursedirs = venv logs reports

3.3 日志配置：规范化用例运行日志

测试日志是问题定位的关键，Pytest内置了日志模块，可通过ini配置文件自定义日志的级别、格式、输出路径等。核心配置项如下：

python 复制代码

[pytest]
; 1. 日志级别：DEBUG < INFO < WARNING < ERROR < CRITICAL，默认WARNING
log_level = INFO

; 2. 日志格式：包含时间、模块名、级别、消息
log_format = %(asctime)s - %(name)s - %(levelname)s - %(message)s

; 3. 时间格式：自定义日志中的时间显示格式
log_date_format = %Y-%m-%d %H:%M:%S

; 4. 日志文件路径：将日志写入文件（默认只输出到控制台）
log_file = logs/pytest_run.log

; 5. 日志文件编码：避免中文乱码
log_file_encoding = utf-8

; 6. 日志文件大小：轮转日志（需安装pytest-logrotate插件）
; log_file_max_bytes = 10485760  ; 10MB
; log_file_backup_count = 5      ; 保留5个备份文件

日志格式参数说明：

%(asctime)s：日志记录时间。
%(name)s：日志产生的模块名。
%(levelname)s：日志级别。
%(message)s：日志具体消息。
%(filename)s：日志产生的文件名。
%(lineno)d：日志产生的行号。

实战效果：配置后，运行用例会在logs/pytest_run.log文件中生成如下日志：

bash 复制代码

2024-05-20 14:30:00 - test_login - INFO - 开始执行登录用例
2024-05-20 14:30:01 - test_login - INFO - 登录成功，返回结果：{"code":200,"msg":"success"}
2024-05-20 14:30:01 - test_login - INFO - 登录用例执行完成

3.4 报告配置：生成专业的测试报告

测试报告是测试结果的直观展示，Pytest通过插件支持多种报告格式（如HTML、Allure），可在ini配置文件中统一配置。

3.4.1 HTML报告配置（pytest-html）

步骤1：安装插件pip install pytest-html

步骤2：在pytest.ini中配置：

python 复制代码

[pytest]
; HTML报告核心配置
addopts = --html=reports/pytest_html_report.html --self-contained-html --css=reports/custom.css

; 报告标题
html_title = "XXX项目自动化测试报告"

; 报告描述
html_description = "测试范围：冒烟测试用例；测试环境：测试环境V2.0"

; 报告日志级别（只显示INFO及以上级别日志）
html_log_level = INFO

参数说明：

--self-contained-html：生成独立的HTML文件，无需依赖外部CSS和JS文件，方便分享。
--css：指定自定义CSS文件，用于美化报告样式（如修改字体、颜色）。
html_title：设置报告的HTML标题（浏览器标签页标题）。

3.4.2 Allure报告配置（pytest-allure-adaptor）

Allure报告比HTML报告更强大，支持交互式展示、趋势分析等功能，配置步骤如下：

步骤1：安装插件pip install allure-pytest（需提前安装Allure命令行工具）

步骤2：在pytest.ini中配置：

python 复制代码

[pytest]
; 生成Allure报告原始数据（json格式）
addopts = --alluredir=reports/allure_raw_data

; Allure报告相关标记（可选）
markers =
    severity: 用例优先级（blocker/critical/normal/minor/trivial）
    feature: 用例所属功能模块
    story: 用例所属子功能

步骤3：运行用例后，生成Allure报告：

allure generate reports/allure_raw_data -o reports/allure_report --clean

用例中使用Allure标记示例：

python 复制代码

import pytest
import allure

@allure.feature("用户模块")
@allure.story("登录功能")
@allure.severity(allure.severity_level.CRITICAL)
def test_login_success():
    with allure.step("步骤1：输入用户名和密码"):
        username = "admin"
        password = "123456"
    with allure.step("步骤2：调用登录接口"):
        result = login(username, password)
    assert result["code"] == 200

3.5 环境变量与路径配置：适配不同运行环境

实际项目中可能需要根据不同环境（开发、测试、生产）配置不同的参数（如数据库地址、接口域名），可通过ini配置文件实现环境变量的统一管理。

3.5.1 pythonpath：添加模块搜索路径

作用：当项目目录结构复杂（如用例目录和公共模块目录不在同一层级）时，通过pythonpath添加模块搜索路径，避免出现ModuleNotFoundError。

实战示例：项目目录结构如下：

bash 复制代码

project/
├── common/          # 公共模块目录
│   ├── api.py       # 接口请求封装模块
├── tests/           # 用例目录
│   ├── test_login.py
└── pytest.ini

配置pythonpath，让test_login.py能导入common/api.py：

bash 复制代码

[pytest]
testpaths = tests
; 添加项目根目录到模块搜索路径（.代表根目录）
pythonpath = .

用例中导入方式：

python 复制代码

from common.api import request_post

def test_login():
    result = request_post("/login", {"username":"admin", "password":"123456"})
    assert result["code"] == 200

3.5.2 env：配置环境变量

作用：定义环境变量，可在测试用例中通过os.getenv()获取，实现不同环境的参数切换。

实战示例：配置测试环境和生产环境的接口域名：

python 复制代码

[pytest]
; 配置环境变量（测试环境）
env =
    BASE_URL=http://test-api.xxx.com
    DB_HOST=test-db.xxx.com
    DB_PORT=3306

; 若切换到生产环境，只需修改为：
; env =
;     BASE_URL=http://prod-api.xxx.com
;     DB_HOST=prod-db.xxx.com
;     DB_PORT=3306

用例中获取环境变量：

python 复制代码

import os
import pytest
from common.api import request_post

def test_login():
    base_url = os.getenv("BASE_URL")
    url = f"{base_url}/login"
    result = request_post(url, {"username":"admin", "password":"123456"})
    assert result["code"] == 200

3.6 插件配置：扩展Pytest功能

Pytest的强大之处在于其丰富的插件生态，可通过ini配置文件指定需要加载的插件，避免每次运行时手动指定。

3.6.1 plugins：指定加载的插件

作用：列出需要自动加载的插件，Pytest运行时会自动初始化这些插件，无需在命令行中通过-p参数指定。

实战示例：

python 复制代码

[pytest]
; 加载常用插件
plugins =
    pytest-html          ; HTML报告插件
    pytest-rerunfailures ; 失败重试插件
    pytest-xdist         ; 多线程运行插件
    allure-pytest        ; Allure报告插件
    pytest-django        ; Django项目适配插件（Django项目专用）

说明：插件需提前通过pip install安装，配置后Pytest会自动识别并加载。

3.6.2 常用插件推荐

pytest-xdist：多线程运行用例，大幅提升执行效率，配置参数--numprocesses auto（自动根据CPU核心数分配线程）。
pytest-cov：生成代码覆盖率报告，配置参数--cov=common --cov-report=html（统计common目录的覆盖率并生成HTML报告）。
pytest-mock：简化单元测试中的mock操作，无需手动导入unittest.mock。

四、实战场景，打造复杂Pytest配置方案

前面我们讲解了单个配置项的用法，本节将结合企业级项目的实际需求，打造一套完整的pytest.ini配置方案，并配套说明项目目录结构和使用技巧。

4.1 项目目录结构设计

企业级项目通常需要区分用例、公共模块、报告、日志等目录，合理的目录结构能提高项目的可维护性，推荐结构如下：

python 复制代码

XXX项目/
├── common/                # 公共模块目录
│   ├── api.py             # 接口请求封装
│   ├── db.py              # 数据库操作封装
│   ├── utils.py           # 工具函数（如时间、加密）
├── config/                # 配置文件目录
│   ├── dev.ini            # 开发环境配置
│   ├── test.ini           # 测试环境配置
│   ├── prod.ini           # 生产环境配置
├── data/                  # 测试数据目录
│   ├── login_data.json    # 登录用例数据
│   ├── pay_data.csv       # 支付用例数据
├── logs/                  # 日志目录
├── reports/               # 报告目录
│   ├── html/              # HTML报告
│   ├── allure/            # Allure报告
│   ├── custom.css         # 自定义报告样式
├── tests/                 # 用例目录
│   ├── smoke/             # 冒烟测试用例
│   │   ├── test_login.py
│   │   ├── test_home.py
│   ├── regression/        # 回归测试用例
│   │   ├── test_pay.py
│   │   ├── test_order.py
│   ├── conftest.py        # 局部钩子函数和夹具
├── pytest.ini             # 核心配置文件
├── requirements.txt       # 依赖包清单
└── README.md              # 项目说明文档

4.2 完整pytest.ini配置方案

结合上述目录结构，设计一套覆盖用例发现、运行参数、日志、报告、插件的完整配置：

python 复制代码

[pytest]
; ===================== 用例发现规则配置 =====================
; 指定用例根目录（smoke和regression目录均在tests下）
testpaths = tests
; 用例文件命名规则：test_*.py或case_*.py
python_files = test_*.py case_*.py
; 用例类命名规则：Test*或Case*
python_classes = Test* Case*
; 用例方法命名规则：test_*或case_*，排除test_skip*
python_functions = test_* case_* !test_skip*
; 排除不需要递归的目录（venv、logs、reports等）
norecursedirs = venv logs reports data config

; ===================== 运行参数配置 =====================
; 综合运行参数：详细模式+显示打印+HTML报告+Allure数据+失败重试2次+多线程+只运行smoke标记用例
addopts = -v -s --html=reports/html/report.html --self-contained-html --css=reports/custom.css --alluredir=reports/allure/raw_data --reruns 2 --numprocesses auto -m smoke
; 注册用例标记（统一管理标记）
markers =
    smoke: 冒烟测试用例，覆盖核心业务流程（如登录、首页访问）
    regression: 回归测试用例，覆盖全量功能
    critical: 关键用例，影响核心业务（如支付、下单）
    minor: 次要用例，不影响核心业务（如个人资料修改）

; ===================== 日志配置 =====================
; 日志级别：INFO（显示INFO及以上级别日志）
log_level = INFO
; 日志格式：时间-模块-级别-消息-文件名-行号
log_format = %(asctime)s - %(name)s - %(levelname)s - %(message)s - %(filename)s:%(lineno)d
; 时间格式：年-月-日 时:分:秒
log_date_format = %Y-%m-%d %H:%M:%S
; 日志文件路径及编码
log_file = logs/pytest_run.log
log_file_encoding = utf-8

; ===================== 模块搜索路径配置 =====================
; 添加项目根目录到模块搜索路径，确保common等目录可被导入
pythonpath = .

; ===================== 环境变量配置（测试环境） =====================
env =
    BASE_URL=http://test-api.xxx.com
    DB_HOST=test-db.xxx.com
    DB_PORT=3306
    DB_USER=test_user
    DB_PASSWORD=test_pass123
    TIMEOUT=30

; ===================== 报告配置 =====================
; HTML报告配置
html_title = "XXX项目自动化测试报告（冒烟测试）"
html_description = "测试环境：测试环境V2.0；测试时间：{当前时间}；测试人员：测试组；用例总数：{总用例数}；通过数：{通过数}；失败数：{失败数}"
html_log_level = INFO

; ===================== 插件配置 =====================
; 自动加载的插件（需提前pip安装）
plugins =
    pytest-html
    pytest-rerunfailures
    pytest-xdist
    allure-pytest
    pytest-cov
    pytest-mock

; ===================== 代码覆盖率配置 =====================
; 统计common目录和tests目录的代码覆盖率
cov = common tests
; 覆盖率报告格式：HTML+控制台摘要
cov_report =
    html:reports/cov/html
    term-missing:reports/cov/term.txt
; 排除覆盖率统计的文件（如utils.py中的某些函数）
cov_exclude =
    common/utils.py:1-10  ; 排除utils.py的1-10行
    common/api.py:50-60   ; 排除api.py的50-60行

4.3 配置使用技巧

多环境配置切换 ：前面的配置是测试环境的，若需要切换到开发环境，可通过以下两种方式实现：方式一：复制pytest.ini为pytest_dev.ini，修改env配置项，运行时指定配置文件：pytest -c pytest_dev.ini。
方式二：通过命令行参数覆盖环境变量：pytest --env=BASE_URL=http://dev-api.xxx.com（需结合conftest.py实现参数接收）。

动态生成报告描述 ：配置中的html_description无法直接获取运行时间和用例数量，可通过conftest.py的pytest_configure钩子函数动态修改：

python 复制代码

import datetime
import pytest

def pytest_configure(config):
    # 动态生成测试时间
    test_time = datetime.datetime.now().strftime("%Y-%m-%d %H:%M:%S")
    # 设置报告描述（替换占位符）
    config.option.html_description = f"测试环境：测试环境V2.0；测试时间：{test_time}；测试人员：测试组"
    # 若需要获取用例数量，需结合pytest_collection_modifyitems钩子函数统计

忽略特定警告：运行时若出现无关警告（如第三方库的警告），可通过配置忽略：
python 复制代码
```
[pytest]
; 忽略特定警告（以DeprecationWarning为例）
filterwarnings =
    ignore::DeprecationWarning
```

五、配置优化与问题排查

掌握基础配置后，还需要了解配置优化技巧和常见问题的排查方法，提升配置的稳定性和可维护性。

5.1 配置优化技巧

配置分层管理：对于大型项目，可将配置分为"全局配置"和"局部配置"：全局配置：pytest.ini放在项目根目录，定义通用规则（如插件、日志格式）。
局部配置：在tests的子目录（如smoke、regression）下创建conftest.py，定义局部规则（如子目录专属的夹具）。
配置注释规范化：为每个配置项添加详细注释，说明用途、参数含义和修改注意事项，尤其对于团队协作项目，注释能大幅提高配置的可维护性。示例：
python 复制代码
```
[pytest]
; 用例文件命名规则：支持test_*.py和case_*.py
; 修改注意：若新增规则需同步告知团队，避免用例无法被识别
python_files = test_*.py case_*.py
```

使用变量复用配置：对于重复出现的配置值（如报告目录），可通过自定义变量复用（需结合conftest.py实现）：

python 复制代码

# conftest.py
import pytest

@pytest.fixture(scope="session")
def report_dir():
    return "reports/html"

def pytest_configure(config):
    # 复用report_dir变量设置报告路径
    config.option.htmlpath = f"{report_dir()}/report.html"

5.2 常见问题排查方法

5.2.1 配置不生效问题

现象：修改pytest.ini后，配置未按预期生效（如用例未被识别、报告未生成）。

排查步骤：

检查文件命名和位置：确认文件名为pytest.ini且放在项目根目录。
检查配置语法：确保键值对格式正确（无多余空格、通配符使用正确），注释以;开头。
验证配置加载：执行pytest --help，在"INI options"部分查看配置是否被加载。
检查优先级：确认命令行参数未覆盖ini配置（如ini配置了testpaths=tests，但命令行执行了pytest case/）。
清理缓存：若配置修改后仍未生效，可删除Pytest缓存目录（.pytest_cache）后重新运行。

5.2.2 插件加载失败问题

现象：配置了plugins = pytest-html，但运行时提示"插件未找到"。

排查步骤：

检查插件是否安装：执行pip list | grep 插件名，确认插件已安装。
检查插件名称是否正确：部分插件的配置名称与包名不同（如Allure插件包名为allure-pytest，配置名也是allure-pytest）。
检查Python环境：若使用虚拟环境，确认插件安装在当前虚拟环境中（执行which pip查看pip路径是否对应虚拟环境）。

5.2.3 用例识别失败问题

现象：编写的用例未被Pytest识别，运行时提示"no tests ran"。

排查步骤：

检查用例命名：确认用例文件、类、方法符合python_files、python_classes、python_functions配置的规则。
检查用例目录：确认用例所在目录在testpaths配置中，且未被norecursedirs排除。
检查用例是否被标记排除：确认用例未被python_functions中的排除规则（如!test_skip*）排除。
检查用例类是否有__init__方法：若用例类定义了__init__，Pytest无法实例化，需删除或修改。