1. 项目概述为什么选择 Pytest Playwright 这套组合拳如果你正在为 Web 自动化测试的选型头疼或者觉得现有的 Selenium 脚本越来越难维护那么今天聊的这套“Pytest Playwright”组合很可能就是你的下一站。这不是什么新鲜概念但绝对是当前最值得投入精力去实践的自动化测试方案之一。我经历过从 Selenium unittest 到 Pytest Playwright 的完整迁移实测下来无论是开发效率、执行稳定性还是代码的可维护性提升都是肉眼可见的。简单来说Pytest是一个功能极其强大且灵活的 Python 测试框架它用起来比 unittest 顺手太多夹具fixture机制、参数化、插件生态让它成为组织测试逻辑的绝佳骨架。而Playwright则是微软开源的一个现代浏览器自动化库它原生支持 Chromium、Firefox 和 WebKit提供了更可靠的自动等待、强大的网络拦截、设备模拟等特性直接对标并超越了 Selenium。把这两者结合起来Pytest 负责管理测试的生命周期、数据驱动和报告生成Playwright 则专注于稳定、高效地执行浏览器操作两者各司其职相得益彰。这套组合拳适合谁呢首先是测试开发工程师和自动化测试工程师这是你们提升脚本质量和效率的利器。其次是对质量有要求的开发同学可以用来做快速的 E2E 冒烟测试。即便是测试新手跟着清晰的步骤和最佳实践走也能快速上手写出结构清晰、不易过时的自动化脚本。接下来我们就从零开始拆解如何将这套组合拳真正“落地”到你的项目中。2. 环境搭建与核心工具链配置工欲善其事必先利其器。一个稳定、可复现的测试环境是自动化成功的基石。这里我会详细说明每一步的操作和背后的考量帮你避开初期最常见的那些坑。2.1 Python 环境与依赖管理我强烈建议使用虚拟环境来隔离你的项目依赖。这能避免不同项目间包版本的冲突也是团队协作的标配。# 使用 venv 创建虚拟环境Python 3.3 内置 python -m venv playwright-env # 激活虚拟环境 # Windows: playwright-env\Scripts\activate # macOS/Linux: source playwright-env/bin/activate激活后你的命令行提示符前会出现(playwright-env)字样。接下来安装核心包pip install pytest playwright这里有两个关键点第一直接pip install playwright会安装 Playwright 的核心 Python 库。第二Pytest 和 Playwright 的版本兼容性通常很好但如果你遇到奇怪的问题可以尝试使用较新的稳定版。安装完 Python 库后Playwright 还需要安装它自带的浏览器内核。playwright install这个命令会下载 Chromium、Firefox 和 WebKit 的预备版本到本地缓存中。为什么不用系统已安装的 Chrome因为 Playwright 使用专门构建的浏览器版本以确保 API 的完全兼容性和执行的绝对一致性这是其高稳定性的重要原因。playwright install默认会安装所有三个浏览器如果你确定只使用 Chromium可以运行playwright install chromium来节省时间和磁盘空间。注意在某些网络环境下下载浏览器可能会很慢或失败。你可以尝试设置环境变量来使用国内镜像加速例如set PLAYWRIGHT_DOWNLOAD_HOSThttps://npmmirror.com/mirrors/playwrightWindows或export PLAYWRIGHT_DOWNLOAD_HOSThttps://npmmirror.com/mirrors/playwrightmacOS/Linux然后再执行install命令。2.2 IDE 配置与必备插件一个好的集成开发环境能极大提升编码效率。我主要使用VSCode和PyCharm。在 VSCode 中安装官方 Python 扩展ms-python.python。安装 Pytest 扩展littlefoxteam.vscode-python-test-adapter它可以在侧边栏可视化地发现、运行和调试测试用例。安装 Playwright 官方扩展ms-playwright.playwright用于录制脚本和查看测试跟踪。在 PyCharm 中确保已配置好你的虚拟环境作为项目解释器File - Settings - Project - Python Interpreter。右键项目目录选择“Mark Directory as” - “Sources Root”这样导入自定义模块会更方便。PyCharm 对 Pytest 有原生支持在运行配置中选择 Pytest 即可。实操心得无论用哪个 IDE都务必开启代码格式化工具如 Black和语法检查如 Pylint 或 Flake8。自动化脚本也是代码保持一致的风格和避免低级错误对长期维护至关重要。可以在项目根目录放一个.pre-commit-config.yaml文件在提交代码前自动做这些检查。2.3 项目目录结构设计一个清晰、可扩展的目录结构是项目可持续发展的关键。不要把所有文件都扔在根目录下。下面是我在实践中总结出的一种推荐结构your-automation-project/ ├── conftest.py # Pytest 全局配置文件定义全局夹具 ├── requirements.txt # 项目依赖清单 ├── pytest.ini # Pytest 运行配置文件 ├── pages/ # 页面对象模型Page Object目录 │ ├── __init__.py │ ├── login_page.py │ └── home_page.py ├── tests/ # 测试用例目录 │ ├── __init__.py │ ├── test_login.py │ └── test_search.py ├── fixtures/ # 自定义夹具目录可选复杂时可分离 │ └── data_fixtures.py ├── utils/ # 工具函数目录 │ ├── __init__.py │ ├── logger.py │ └── api_client.py ├── data/ # 测试数据文件目录 │ └── test_data.json ├── reports/ # 测试报告输出目录.gitignore │ └── html/ └── screenshots/ # 失败截图目录.gitignore为什么这么设计conftest.py这是 Pytest 的魔力所在。在这里定义的夹具fixture可以被任何子目录下的测试文件使用。我们会把 Playwright 浏览器的启动/关闭、页面的创建等核心夹具放在这里。pages/严格遵循Page Object Model (PO模型)将每个页面或可重用的组件封装成一个类。这是降低脚本维护成本最有效的手段。tests/测试用例应该只包含测试逻辑调用 Page Object 的方法、做断言而不包含具体的定位器或浏览器操作细节。分离数据和工具让data/和utils/独立使得数据驱动和通用功能复用变得清晰。在项目根目录创建requirements.txt文件固化你的依赖pytest7.0.0 playwright1.40.0 pytest-html4.0.0 # 用于生成HTML报告 pytest-xdist3.0.0 # 用于并行测试使用pip install -r requirements.txt即可一键安装所有依赖。3. 核心概念与最佳实践深度解析掌握了工具我们还需要理解其背后的设计哲学和最佳实践这样才能写出“优雅”而健壮的测试代码。3.1 Pytest 夹具Fixture的精髓与应用夹具是 Pytest 的灵魂。你可以把它理解为测试的“脚手架”或“资源管理器”。它的核心价值在于提供可复用的准备和清理逻辑。一个最经典的例子就是为每个测试用例提供一个新的 Playwright 页面Page对象。# 在 conftest.py 中 import pytest from playwright.sync_api import Page, BrowserContext, Browser, sync_playwright pytest.fixture(scopesession) def browser(): 启动一个浏览器实例整个测试会话只启动一次。 playwright sync_playwright().start() # 建议使用 headlessFalse 在调试时查看浏览器正式运行改为 True browser playwright.chromium.launch(headlessFalse, slow_mo500) # slow_mo 可放慢操作便于观察 yield browser browser.close() playwright.stop() pytest.fixture def context(browser): 为每个测试用例创建一个新的浏览器上下文Context。 上下文相当于一个独立的会话隔离 cookies、localStorage 等。 context browser.new_context() yield context context.close() pytest.fixture def page(context): 为每个测试用例创建一个新的页面Page。这是最常用的夹具。 page context.new_page() yield page page.close()关键解析scope参数定义了夹具的生命周期。function默认每个测试函数运行一次。class每个测试类运行一次。module每个.py文件运行一次。session整个 Pytest 执行过程运行一次。像browser这种重型资源用sessionscope 能极大提升测试速度。yield关键字这是夹具的精妙之处。yield之前的代码是“设置”setupyield之后的是“清理”teardown。测试函数执行时实际上是在yield处“暂停”并获取返回的资源如page对象测试结束后再执行清理代码。夹具依赖page夹具依赖contextcontext又依赖browser。Pytest 会自动解析并按照正确的顺序执行它们。在测试用例中你只需要将夹具名作为参数传入即可使用# tests/test_login.py def test_login_with_valid_credentials(page): # 这里的 page 就是由 conftest.py 中的 page 夹具提供的 page.goto(https://example.com/login) # ... 执行登录操作 assert page.inner_text(#welcome) Welcome, User!实操心得对于需要登录状态的测试我通常会创建一个logged_in_page夹具它基于page夹具先自动完成登录流程然后返回这个已登录状态的page对象。这样所有需要登录的测试用例都直接使用logged_in_page避免了在每个用例中重复编写登录代码。3.2 Playwright 的同步与异步 API 抉择Playwright 提供了同步和异步两套 API。对于大多数自动化测试场景我推荐使用同步 API。为什么更符合直觉测试步骤通常是顺序执行的同步代码的“上一步完成再执行下一步”的写法更直观易于阅读和调试。与 Pytest 集成更简单Pytest 本身对同步函数的支持是最直接的。虽然 Pytest 也支持异步通过pytest-asyncio插件但这引入了额外的复杂性和学习成本。足够高效Playwright 的同步 API 底层仍然是异步的但它通过智能等待Auto-waiting等方式让你在写同步代码时也能获得近乎异步的性能。对于 UI 自动化响应时间瓶颈通常在浏览器渲染和网络请求而非代码执行模式。同步 API 的写法就是上面例子中看到的直接from playwright.sync_api import ...。只有在极少数需要并发控制大量浏览器标签页或并行处理非 UI 密集型任务的场景下才需要考虑异步 API。对于 99% 的 E2E 测试同步 API 是最佳选择。3.3 健壮的元素定位策略与自动等待元素定位是 UI 自动化的基石也是脚本脆弱的主要原因。Playwright 提供了丰富的定位器Locator并且其设计哲学是“始终使用 Locator 对象”。最佳定位策略优先级从高到低Role-based 定位这是 Playwright 最推荐的方式通过元素的 ARIA 角色、名称等语义化属性来定位最能抵抗 UI 结构变化。page.get_by_role(button, nameSign in).click() page.get_by_label(User Name).fill(testuser)Text-based 定位通过元素内的文本来定位。page.get_by_text(Submit).click() page.get_by_text(Welcome, exactTrue).is_visible()Test ID 定位与开发约定为关键测试元素添加专用的># 前端元素button># 错误做法在 Playwright 中通常不需要 # page.wait_for_selector(#submit, statevisible, timeout10000) # page.click(#submit) # 正确做法直接操作Playwright 会帮你等待 page.locator(#submit).click()只有当你要等待一个特定的、非交互性的状态时如导航完成、网络请求结束才需要使用显式等待如page.wait_for_url(**/dashboard)或page.wait_for_response(**/api/user)。实操心得将定位器集中管理在 Page Object 中。不要在测试用例里散落着各种page.locator(“...”)。这样当 UI 变化时你只需要在一个地方修改定位器字符串。# pages/login_page.py class LoginPage: def __init__(self, page): self.page page self.username_input page.get_by_label(Username) self.password_input page.get_by_label(Password) self.submit_button page.get_by_role(button, nameSign In) def navigate(self): self.page.goto(/login) def login(self, username, password): self.username_input.fill(username) self.password_input.fill(password) self.submit_button.click()4. 测试用例设计与高级功能集成有了稳固的基础我们就可以构建复杂、可维护的测试套件了。4.1 数据驱动测试参数化的艺术Pytest 的pytest.mark.parametrize装饰器是实现数据驱动的利器。它允许你用不同的数据集运行同一个测试函数。import pytest from pages.login_page import LoginPage # 测试数据可以定义在模块内或从外部文件JSON, YAML, CSV加载 LOGIN_TEST_DATA [ (valid_user, valid_pass, True, Login successful), (invalid_user, valid_pass, False, Invalid username), (valid_user, , False, Password is required), ] pytest.mark.parametrize(username, password, expected_success, expected_message, LOGIN_TEST_DATA) def test_login_with_multiple_data_sets(page, username, password, expected_success, expected_message): login_page LoginPage(page) login_page.navigate() login_page.login(username, password) if expected_success: # 验证登录成功后的页面或元素 assert page.url.contains(/dashboard) else: # 验证错误提示信息 error_element page.get_by_text(expected_message) assert error_element.is_visible()高级技巧你可以将测试数据放在外部的data/test_data.json或data/login_cases.yaml文件中然后在conftest.py中通过夹具来读取和提供这些数据使得测试逻辑与数据完全分离。4.2 失败重试与截图钩子UI 自动化测试天生具有“脆性”偶尔的失败可能是由于短暂的网络延迟、资源加载问题或动画干扰。Pytest 可以通过插件提供失败重试机制。首先安装插件pip install pytest-rerunfailures。 然后在pytest.ini中配置[pytest] addopts --reruns 2 --reruns-delay 1 # 表示失败后重试2次每次间隔1秒更重要的是我们需要在测试失败时自动截图或录制视频这是定位问题最直接的证据。我们可以通过 Pytest 的钩子函数hook来实现。# 在 conftest.py 中 import pytest from datetime import datetime import os pytest.hookimpl(tryfirstTrue, hookwrapperTrue) def pytest_runtest_makereport(item, call): 获取测试用例执行结果的钩子函数。 当测试失败时自动截图并附加到HTML报告中。 outcome yield report outcome.get_result() # 只关注测试用例call阶段的失败或错误setup/teardown 阶段不管 if report.when call and report.failed: # 获取测试用例中的 page 夹具如果存在 page item.funcargs.get(page) if page: # 创建截图目录 screenshot_dir screenshots os.makedirs(screenshot_dir, exist_okTrue) # 生成带时间戳的文件名 timestamp datetime.now().strftime(%Y%m%d_%H%M%S) test_name item.name screenshot_path os.path.join(screenshot_dir, f{test_name}_{timestamp}.png) # 截图 page.screenshot(pathscreenshot_path, full_pageTrue) # 将截图路径附加到测试报告上供 pytest-html 等插件使用 if hasattr(report, extra): from pytest_html import extras report.extra.append(extras.png(screenshot_path))实操心得除了截图Playwright 还支持在测试开始时自动录制追踪文件Trace。Trace 文件包含了测试执行过程中完整的 DOM 快照、网络请求、控制台日志等信息可以通过 Playwright 的命令行工具playwright show-trace trace.zip进行可视化回放是调试复杂问题的终极武器。可以在browser.new_context()时配置record_har_path或record_video_dir来启用。4.3 并行测试与分布式执行当测试套件规模增长后串行执行会非常耗时。Pytest 可以通过pytest-xdist插件轻松实现并行测试。安装pip install pytest-xdist。 运行pytest -n auto。auto会自动根据你的 CPU 核心数创建 worker 进程。重要注意事项会话级session夹具并行时scopesession的夹具如我们的browser会在每个 worker 进程中单独初始化一次而不是全局一次。这通常是期望的行为因为每个进程需要独立的浏览器实例。资源竞争确保你的测试用例是相互独立的不依赖共享的外部状态如数据库的特定记录。使用context夹具可以很好地隔离浏览器状态。测试数据隔离为每个 worker 使用独立的测试账号或数据前缀避免数据冲突。对于超大型项目可以考虑使用更复杂的分布式执行系统但pytest-xdist已经能解决大部分项目的提速需求。5. 报告生成与持续集成流水线测试执行的最终价值在于快速反馈。清晰、美观的报告和自动化的执行流程是关键。5.1 生成丰富的测试报告pytest-html插件可以生成详细的 HTML 报告。安装pip install pytest-html。 运行pytest --htmlreports/report.html --self-contained-html。--self-contained-html参数会将 CSS 和图片内嵌到单个 HTML 文件中方便分享。你可以在conftest.py中进一步定制报告例如添加环境信息# conftest.py def pytest_configure(config): config._metadata[Project] My Awesome Web App config._metadata[Test Environment] Staging config._metadata[Browser] Chromium def pytest_html_results_table_header(cells): cells.insert(2, html.th(Description)) cells.insert(1, html.th(Time, class_sortable time, coltime)) def pytest_html_results_table_row(report, cells): cells.insert(2, html.td(report.description)) cells.insert(1, html.td(datetime.now(), class_col-time))结合之前提到的失败截图钩子截图也会被嵌入到 HTML 报告中点击即可查看。5.2 集成到 CI/CD 流水线以 GitHub Actions 为例自动化测试只有集成到持续集成/持续部署CI/CD流水线中才能发挥最大价值。以下是一个简单的 GitHub Actions 工作流配置示例# .github/workflows/playwright-pytest.yml name: Playwright E2E Tests on: push: branches: [ main, develop ] pull_request: branches: [ main ] jobs: test: timeout-minutes: 30 runs-on: ubuntu-latest steps: - uses: actions/checkoutv3 - name: Set up Python uses: actions/setup-pythonv4 with: python-version: 3.10 - name: Install dependencies run: | python -m pip install --upgrade pip pip install -r requirements.txt playwright install --with-deps chromium # 只安装 Chromium 及其系统依赖 - name: Run your tests run: | pytest tests/ \ --htmlreports/report.html \ --self-contained-html \ -n auto \ --reruns 2 \ --reruns-delay 1 - name: Upload test report if: always() # 即使测试失败也上传报告 uses: actions/upload-artifactv3 with: name: playwright-test-report path: | reports/ screenshots/这个工作流会在代码推送或拉取请求时自动触发在一个干净的 Ubuntu 环境中安装依赖、运行测试并行重试并将生成的 HTML 报告和截图打包上传供你下载查看。实操心得在 CI 环境中务必以无头模式headlessTrue运行浏览器并且可以加上--slow-mo参数适当放慢操作如slow_mo100这能在不依赖 GUI 的情况下增加稳定性。同时确保 CI 机器有足够的内存因为每个浏览器实例都会消耗资源。6. 从零到一的完整实战案例用户登录流程让我们将所有知识点串联起来实现一个完整的、可运行的登录测试流程。第一步搭建项目骨架按照第 2.3 节的目录结构创建所有文件和文件夹。第二步编写 Page Object (pages/login_page.py)from playwright.sync_api import Page, expect class LoginPage: def __init__(self, page: Page): self.page page self.url https://the-internet.herokuapp.com/login # 一个经典的练习网站 self.username_input page.locator(#username) self.password_input page.locator(#password) self.submit_button page.locator(button[typesubmit]) self.success_message page.locator(.flash.success) self.error_message page.locator(.flash.error) def navigate(self): self.page.goto(self.url) def fill_credentials(self, username: str, password: str): self.username_input.fill(username) self.password_input.fill(password) def submit(self): self.submit_button.click() def login(self, username: str, password: str): 一站式登录方法 self.navigate() self.fill_credentials(username, password) self.submit() def get_success_message(self) - str: return self.success_message.inner_text() def get_error_message(self) - str: return self.error_message.inner_text()第三步编写测试用例 (tests/test_login.py)import pytest from pages.login_page import LoginPage class TestLogin: 登录功能测试集 pytest.fixture(autouseTrue) def setup(self, page): 每个测试方法前自动执行初始化页面对象 self.login_page LoginPage(page) def test_login_success(self): 测试使用正确凭据登录成功 self.login_page.login(tomsmith, SuperSecretPassword!) # 使用 Playwright 的 expect 断言可读性更好且自带等待 expect(self.login_page.page).to_have_url(https://the-internet.herokuapp.com/secure) assert You logged into a secure area! in self.login_page.get_success_message() pytest.mark.parametrize(username, password, expected_error, [ (wrong_user, SuperSecretPassword!, Your username is invalid!), (tomsmith, wrong_pass, Your password is invalid!), (, , Your username is invalid!), ]) def test_login_failure(self, username, password, expected_error): 数据驱动测试多种错误登录场景 self.login_page.login(username, password) # 验证仍然在登录页面 expect(self.login_page.page).to_have_url(self.login_page.url) # 验证错误信息包含预期文本 actual_error self.login_page.get_error_message() assert expected_error in actual_error, fExpected {expected_error} in error message, but got {actual_error}第四步配置全局夹具与报告 (conftest.py)import pytest from playwright.sync_api import sync_playwright import os from datetime import datetime pytest.fixture(scopesession) def browser(): playwright sync_playwright().start() # CI 环境中可以通过环境变量判断是否为无头模式 is_headless os.getenv(CI, false).lower() true browser playwright.chromium.launch(headlessis_headless, slow_moint(os.getenv(SLOW_MO, 0))) yield browser browser.close() playwright.stop() pytest.fixture def context(browser): # 可以在这里配置上下文选项如视口大小、语言、权限等 context browser.new_context(viewport{width: 1920, height: 1080}) yield context context.close() pytest.fixture def page(context): page context.new_page() yield page page.close() # 可选但推荐失败截图钩子函数同上文示例此处省略...第五步运行与查看结果在项目根目录下执行pytest tests/test_login.py -v --htmlreports/report.html --self-contained-html打开生成的reports/report.html你就能看到一个清晰的测试报告包含通过/失败的用例、执行时间如果配置了截图钩子还能直接查看失败时的屏幕截图。这个案例麻雀虽小五脏俱全涵盖了环境搭建、PO模型、数据驱动、夹具使用、断言和报告生成的全流程。你可以以此为基础不断扩展pages/目录下的页面对象和tests/目录下的测试用例构建起属于你自己的强大自动化测试体系。记住好的自动化测试不是一蹴而就的而是通过持续迭代、重构和遵循最佳实践慢慢积累起来的。