Pytest标记（mark）实战指南：-m 用法

Tom Boom

已于 2025-06-10 09:49:00 修改

阅读量875

点赞数 8

CC 4.0 BY-SA版权

分类专栏：软件自动化测试CICD 文章标签： pytest 测试用例

于 2025-06-10 08:48:52 首次发布

本文链接：https://blog.csdn.net/sw3300255/article/details/148548014

软件自动化测试CICD 专栏收录该内容

14 篇文章

订阅专栏

Pytest标记（mark）实战指南：精准控制测试用例执行的艺术

一、代码全景解析

import pytest
from config.driver_config import DriverConfig

class TestPytestMClass:
    @pytest.mark.bing
    def test_open_bing(self):
        # 测试bing的代码
    
    @pytest.mark.baidu
    def test_open_baidu(self):
        # 测试百度的代码
    
    @pytest.mark.google
    def test_open_google(self):
        # 测试Google的代码

核心组件解析

组件	作用	重要性
@pytest.mark	创建自定义标记	★★★★★
pytest -m	命令行标记筛选器	★★★★★
逻辑运算符	and/or/not	★★★★☆
DriverConfig	浏览器驱动管理	★★★★☆

二、pytest标记系统深度解析

1. 标记的本质与作用

@pytest.mark.baidu

核心价值：

为测试用例添加语义化标签
实现测试用例的逻辑分组
支持选择性执行测试用例
替代传统的测试目录分类方式

2. 标记的底层实现原理

注册机制：在pytest.ini中预先注册标记

[pytest]
markers =
  bing: 测试Bing搜索
  baidu: 测试百度搜索
  google: 测试Google搜索

元数据存储：pytest将标记信息存入测试用例的__pytest_mark__属性
运行时过滤：-m参数触发pytest的标记匹配引擎


## 三、pytest -m 命令实战详解

### 1. 基础筛选：单个标记
```bash
pytest -m baidu

执行结果：仅运行标记为baidu的测试用例
实际输出：

collected 3 items / 2 deselected / 1 selected
test_pytest_m.py::TestPytestMClass::test_open_baidu

2. 逻辑或：多标记选择

pytest -m "baidu or bing"

执行结果：运行baidu或bing标记的测试用例
应用场景：同时测试国内搜索引擎

3. 逻辑与：交集筛选

pytest -m "baidu and bing"

执行结果：运行同时具有baidu和bing标记的用例
特殊说明：此例中无同时标记的用例，因此不会执行任何测试

4. 逻辑非：排除筛选

pytest testcases/test_pytest_m.py -m "not baidu"

执行结果：排除所有baidu标记的用例
实际输出：

test_pytest_m.py::TestPytestMClass::test_open_bing 
test_pytest_m.py::TestPytestMClass::test_open_google

5. 组合条件：混合逻辑

pytest testcases/test_pytest_m.py -m "baidu and not bing"

执行结果：运行baidu标记但排除bing标记的用例
解析：由于没有同时满足条件的用例，实际不会执行任何测试

四、解决的核心问题

1. 测试执行的精准控制

痛点	传统方案	pytest标记方案
运行特定功能测试	目录分离	标记分组
快速执行冒烟测试	单独脚本	`@pytest.mark.smoke`
排除不稳定测试	注释代码	`-m "not flaky"`
多环境适配测试	配置参数	`@pytest.mark.env('prod')`

2. 测试资源优化

时间成本：从10分钟全量测试 → 2分钟核心测试
硬件成本：减少80%的浏览器实例创建
维护成本：无需维护多个测试脚本副本

五、真实落地案例

案例1：电商平台日常测试

需求背景：

每日需要快速验证核心购物流程
每周执行全量回归测试
需要排除已知不稳定的支付测试

解决方案：

# 标记核心购物流程
@pytest.mark.smoke
def test_add_to_cart():
    pass

# 标记支付流程（已知不稳定）
@pytest.mark.flaky
def test_payment():
    pass

# 标记全量测试
@pytest.mark.full_regression
def test_product_search():
    pass

执行策略：

# 每日冒烟测试
pytest -m smoke

# 每周全量回归（排除不稳定用例）
pytest -m "full_regression and not flaky"

# 修复支付问题后单独验证
pytest -m payment

案例2：多浏览器兼容性测试

需求背景：

主要功能需在Chrome/Firefox测试
Edge只需验证核心流程
Safari仅测试登录功能

解决方案：

# 浏览器兼容性标记
@pytest.mark.chrome
@pytest.mark.firefox
def test_search_function():
    pass

@pytest.mark.edge
def test_checkout():
    pass

@pytest.mark.safari
def test_login():
    pass

执行策略：

# Chrome和Firefox全功能测试
pytest -m "chrome or firefox"

# Edge核心流程测试
pytest -m edge

# Safari登录测试
pytest -m safari

案例3：多环境测试套件

需求背景：

开发环境：快速测试新功能
测试环境：完整功能验证
生产环境：仅核心流程验证

解决方案：

# 环境特定标记
@pytest.mark.dev
def test_new_feature():
    pass

@pytest.mark.staging
def test_full_workflow():
    pass

@pytest.mark.prod
def test_critical_path():
    pass

执行策略：

# 开发环境测试
pytest -m dev

# 测试环境全量测试
pytest -m staging

# 生产环境核心测试
pytest -m prod

六、高级应用技巧

1. 标记继承与组合

# 基础标记
@pytest.mark.search
class TestSearchFeatures:
    
    # 继承类标记
    def test_basic_search(self):
        pass
    
    # 组合标记
    @pytest.mark.advanced
    def test_advanced_search(self):
        pass

执行策略：

# 运行所有搜索测试
pytest -m search

# 仅运行高级搜索测试
pytest -m "search and advanced"

2. 参数化与标记结合

import pytest

# 参数化测试数据
@pytest.mark.parametrize("username,password", [
    ("admin", "admin123"),
    ("test", "test123")
])
@pytest.mark.login
def test_user_login(username, password):
    # 登录测试逻辑

执行策略：

# 运行所有登录测试
pytest -m login

# 运行特定用户的登录测试（需要自定义标记）

3. 标记优先级管理

# 优先级标记
@pytest.mark.p0
def test_critical_function():
    pass

@pytest.mark.p1
def test_important_function():
    pass

@pytest.mark.p2
def test_normal_function():
    pass

执行策略：

# 仅运行最高优先级测试
pytest -m p0

# 运行P0和P1优先级测试
pytest -m "p0 or p1"

七、最佳实践指南

1. 标记命名规范

统一前缀：@pytest.mark.ui_/@pytest.mark.api_
语义明确：避免使用模糊的test1/test2
团队共识：建立团队统一的标记字典
避免冲突：不使用Python保留字作为标记名

2. 标记注册管理

pytest.ini配置示例：

[pytest]
markers =
    smoke: 核心冒烟测试
    regression: 回归测试
    chrome: Chrome浏览器测试
    firefox: Firefox浏览器测试
    flaky: 不稳定测试（可能失败）
    p0: 最高优先级测试

3. 避免常见陷阱

标记滥用：单个测试不超过3个标记
逻辑错误：注意and/or的优先级差异
未注册标记：使用未注册标记会触发警告
标记冲突：避免标记名与pytest内置关键字冲突

4. 与CI/CD集成

Jenkins Pipeline示例：

pipeline {
    stages {
        stage('Test') {
            steps {
                script {
                    // 根据分支选择测试范围
                    if (env.BRANCH_NAME == 'develop') {
                        sh 'pytest -m "smoke"'
                    } else if (env.BRANCH_NAME == 'release') {
                        sh 'pytest -m "regression"'
                    } else {
                        sh 'pytest'
                    }
                }
            }
        }
    }
}

八、完整项目结构示例

project/
├── pytest.ini                # 标记注册配置
├── conftest.py               # 全局测试配置
├── testcases/
│   ├── test_search.py        # 搜索功能测试
│   ├── test_login.py         # 登录功能测试
│   └── test_checkout.py      # 结算功能测试
└── config/
    └── driver_config.py      # 浏览器驱动配置

典型测试文件：

# test_search.py
import pytest

@pytest.mark.search
@pytest.mark.smoke
def test_basic_search():
    pass

@pytest.mark.search
@pytest.mark.advanced
def test_advanced_search():
    pass

@pytest.mark.search
@pytest.mark.flaky
def test_search_edge_case():
    pass