说到原理，Playwright 与 Selenium 的主要区别及常见痛点

Playwright 是微软开发的 Web 应用自动化测试框架它不仅提供浏览器自动化。还内置了完整的测试断言、报告和调试能力。

很多团队在选型时会纠结：“明明已经用 Selenium，为什么还要学 Playwright？怎么说呢，”

区别一的观点是。功能定位不同

• Selenium 仅是 Web 自动化库，若想做完整的自动化测试还需额外引入 pytest、TestNG 等框架。
• Playwright 本身就是面向 自动化测试 的框架。内置了期待、截图、视频录制和跟踪等能力，开箱即用。

至于区别二，跨语言与跨浏览器支持更一致

Playwright 原生支持 Chromium、Firefox、WebKit。且 API 在 Python、JavaScript/TypeScript、Java、C# 中保持基本一致；而 Selenium 在不同语言绑定上有时会出现细微差别，导致迁移成本高。

再看基础代码，从环境搭建到首次运行的常见坑点

痛点 1：环境配置繁琐

很多教程直接跳过安装步骤。导致新手在 pip install playwright 后仍然缺少浏览器驱动。老实说，从正确做法是来看，

pip install playwright
playwright install # 自动下载 Chromium/Firefox/WebKit 二进制

痛点 2：混淆同步与异步 API

下面展示最常用的同步写法。 如果你在异步环境中使用一样代码会报错，「'sync_playwright' object has no attribute 'await'`」正是典型症状。

完整同步示例

from playwright.sync_api import sync_playwright
# 1️⃣ 启动 Playwright 驱动进程
p = sync_playwright.start
# 2️⃣ 启动浏览器
browser = p.chromium.launch
# 3️⃣ 新建页面
page = browser.new_page
# 4️⃣ 打开目标页并等待网络空闲
page.goto
print)
# 5️⃣ 定位与操作——这里是自动化最易出错的环节
page.locator.fill # 输入关键词
page.locator.click # 点击查询
# 6️⃣ 把结果全部拿出来
results = page.locator.all
for r in results:
print)
# 7️⃣ 清理资源——遗忘这一步会导致后台残留 chromedriver 进程占用内存
browser.close
p.stop

至于界面等待。解决「元素找不到」或「数据不完整」的根本方案

痛点**：脚本运行太快，页面尚未完成 AJAX 或图片加载，导致 .locator 拿不到节点或者得到空值。

推荐等待方式

• page.wait_for_selector —— 指定元素可见再继续。

# 在打开页后确保搜索框出现再填充
page.wait_for_selector
page.locator.fill
page.locator.click
# 再等待结果列表至少出现一条
page.wait_for_selector
items = page.locator.all
for it in items:
print)

自动化代码助手：能帮上忙但也有局限性

痛点**：依赖录像生成的脚本往往包含大量硬编码坐标或不稳定的选择器，直接复制粘贴会导致后期维护噩梦。

正确使用姿势

1. `playwright codegen`** — 生成初稿，**不要直接提交**。检查每个 locator 是否使用了稳定属性，必要时改为更具语义的选择器。删除重复的 `wait_for_timeout`、`sleep` 或无意义的截图步骤。将生成代码封装为 Page Object Model（POM) 或函数式可复用单元。

playwright codegen https://example.com --target python -o test_example.py
# 生成 test_example.py → 人工审查 →
为健壮版本 

跟踪功能🚩这方面。让失败不再成为盲猜

开启 tracing 的最小改动

from playwright.sync_api import sync_playwright
with sync_playwright as p:
browser = p.chromium.launch
context = browser.new_context
# 开始记录 tracing，screenshots 和 snapshots 默认全开
context.tracing.start
page = context.new_page
page.goto
page.locator.fill
page.locator.click
#…其余断言，其实，# 停止 tracing并保存文件
context.tracing.stop
browser.close


查看 trace 的两种方式