如何使用 playwright inspector

• Playwright Inspector 不需要单独安装，它是 Playwright 内置的 GUI 调试工具。当你安装好 Playwright 库和浏览器后，就可以直接使用它了。
• Playwright Inspector 官网地点： https://playwright.net.cn/python/docs/debug
• 你可以用下面两种方式启动它，它们都会打开同一个 Inspector 窗口，只是用途略有不同：

🎯 核心用法对比

 

功能模式	启动命令	主要用途
代码生成 (Codegen)	playwright codegen [网址]	录制操作，自动生成代码。适合快速获取元素定位器或编写测试用例初稿。
调试模式 (Debug)	PWDEBUG=1 pytest -s	调试已有脚本，单步执行、实时编辑定位器。适合排查测试运行失败的原因

 

1. 启动代码生成器（playwright codegen）

这个模式对新手最友好。它会打开一个浏览器窗口和一个 Inspector 窗口，你在浏览器上的点击、输入等操作会实时转换成代码，并显示在 Inspector 中。

基本用法：在终端中直接运行以下命令，然后就可以开始录制了。

bash

# 替换成你要操作的网站地址
playwright codegen https://www.baidu.com

 

💡 小技巧：你可以在 Inspector 界面顶部的 “Target” 下拉菜单中，将生成的代码切换成你熟悉的语言（如 Python、JavaScript 等）。

2. 进入调试模式（PWDEBUG=1）

这个模式是专门为调试你写好的测试脚本设计的。设置环境变量 PWDEBUG=1 后运行测试，Playwright 会在执行每个操作前暂停，并打开 Inspector 窗口。

基本用法：在运行测试的命令前加上 PWDEBUG=1。

• Mac / Linux:

  bash

  PWDEBUG=1 pytest -s your_test_file.py
  
  或者使用命令：
  export PWDEBUG=1 && pytest -s your_test_file.py
  

• Windows (CMD):

  bash

  set PWDEBUG=1
  pytest -s your_test_file.py
  
  或者使用一行命令：
  

  set PWDEBUG=1 && pytest -s your_test_file.py

• Windows (PowerShell):

  bash

  $env:PWDEBUG=1
  pytest -s your_test_file.py
  

  或者使用一行命令：
  
  $env:PWDEBUG=1; pytest -s your_test_file.py

进入调试模式后，Inspector 允许你做这些事：

• 单步执行：使用工具栏的按钮，一步步运行你的测试，观察每个动作的效果。

• 实时编辑定位器：在 Inspector 的定位器输入框里直接修改，页面上的高亮会实时更新，快速验证定位器是否正确。

• 拾取定位器：点击“Pick Locator”按钮，然后在浏览器页面上悬停，Playwright 会智能推荐最合适的定位器代码。

• 查看可操作性日志：在右侧日志面板，可以看到 Playwright 判断元素是否可见、可用、稳定等状态，帮助你理解元素为什么没被点击到。

3. 在代码中设置断点

如果你不想从头单步执行，可以在脚本中需要暂停的地方加上 page.pause()：

python

from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    browser = p.chromium.launch(headless=False)
    page = browser.new_page()
    page.goto("https://www.baidu.com")
    
    # 脚本执行到这里时会自动暂停，并打开 Inspector
    page.pause() 
    
    # ... 后续操作
    browser.close()

然后用调试模式运行脚本（例如 PWDEBUG=1 pytest -s），测试会快速执行，直到碰到 page.pause() 才停下来并打开 Inspector，非常高效。

💎 总结

简单来说，你不需要为安装 Inspector 做任何额外操作。

• 如果想生成新代码，就用 playwright codegen [网址]。

• 如果想调试旧脚本，就用 PWDEBUG=1 pytest -s