0基础也能会！Playwright保姆级搭建教程，测试小白10分钟跑通自动化

全文手把手，不装逼，不跳过任何步骤，跟着做一定能跑通

写在前面

先说个真实感受——我刚开始接触自动化测试那会儿，被Selenium的环境配置折磨得够呛。ChromeDriver版本对不上、路径配不对、动不动就报错，光是“跑起来”这一步就卡了我一整天。

后来团队里一位老哥推荐了Playwright，说“你试试这个，不用配驱动”。我当时将信将疑，结果十分钟真跑通了第一个脚本。

所以这篇教程就是写给当年的自己，也写给现在的你——不管你之前有没有写过一行自动化代码，跟着下面的步骤走，10分钟之内，我保证你能看到一个浏览器自己打开、自己操作、自己截图。

废话不多说，开整。

第一步：确认你的Python环境

Playwright支持Python 3.7及以上版本。先确认一下你电脑上有没有Python，以及版本对不对。

打开终端（Windows用户打开命令提示符或PowerShell），输入：

python --version

或者

python3 --version

如果显示类似Python 3.9.x 或Python 3.10.x 这样的信息，恭喜，环境没问题。

如果提示“python不是内部或外部命令”，说明Python没装或者没加到系统路径里。去Python官网下载一个最新稳定版，安装时务必勾选“Add Python to PATH” 。这一步别跳过，很多人栽在这儿。

💡 新手提示：如果你用的是Mac，系统自带了Python 2.7，但那个太老了。需要用 python3 命令来调用Python 3。如果 python3 --version 也不行，就去装一个。

第二步：安装Playwright库

就一行命令：

pip install playwright

如果你电脑上有多个Python版本，用这个更保险：

python -m pip install playwright

等它跑完，屏幕上会出现一堆进度条。看到“Successfully installed”就说明库装好了。

💡 新手提示：下载慢的话可以换成国内镜像源，比如 pip install playwright -i https://pypi.tuna.tsinghua.edu.cn/simple。

第三步：安装浏览器驱动（最容易出错的一步，认真看）

装完库之后，还需要装浏览器。这是Playwright和别的库不太一样的地方——它会自动下载Chromium、Firefox、WebKit三个浏览器的内核。

执行：

playwright install

这一步会下载大概1GB左右的文件，网速慢的话可能需要等几分钟。耐心等它跑完，不要中途取消。

如果你只想装Chromium（Chrome内核），可以只装这一个，省时间：

playwright install chromium

⚠️ 常见坑1：如果你在中国大陆，下载浏览器可能会超时或极慢。解决方案是用国内镜像：

set PLAYWRIGHT_DOWNLOAD_HOST=https://registry.npmmirror.com/-/binary/playwright
playwright install

Windows用户把 set 换成 $env:（PowerShell）或者直接配置环境变量。

⚠️ 常见坑2：Mac/Linux用户如果提示权限不够，前面加 sudo。

装完之后，可以验证一下：

playwright --version

能看到版本号就说明一切正常。

第四步：写你的第一个脚本

新建一个文件，名字随便，比如叫first.py。

把下面这段代码原封不动复制进去：

from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    # 启动浏览器（headless=False 表示能看到浏览器窗口）
    browser = p.chromium.launch(headless=False)
    page = browser.new_page()
    
    # 打开百度
    page.goto("https://www.baidu.com")
    
    # 在搜索框输入文字
    page.locator("#kw").fill("Playwright 教程")
    
    # 点击搜索按钮
    page.locator("#su").click()
    
    # 等页面加载完，截图保存
    page.wait_for_load_state("networkidle")
    page.screenshot(path="baidu_result.png")
    
    # 关闭浏览器
    browser.close()
    
    print("搞定！截图已保存。")

保存文件，然后在终端里运行：

python first.py

如果你是Mac且用python3 装的库，就用：

python3 first.py

见证奇迹的时刻——你会看到一个浏览器窗口自动弹出来，打开百度，输入文字，点击搜索，然后自己关掉。

去你的文件夹里找一下，应该有一个叫baidu_result.png 的截图文件。点开看看，是不是百度搜索“Playwright 教程”的结果页面？

第五步：如果你想让脚本“录”出来（更简单的方式）

不想自己敲代码？Playwright有个内置的录制工具叫codegen。

在终端输入：

playwright codegen https://www.baidu.com

它会自动打开一个浏览器窗口和一个代码生成面板。你在浏览器里点哪里、输入什么，代码面板里就会实时生成对应的脚本。

操作完之后，直接把生成的代码复制出来就行——一行都不用自己写。

常见问题速查表

最后说两句

走到这一步，你已经成功跑通了第一个Playwright自动化脚本。

从一个完全没接触过自动化的人，到能让浏览器自己干活——这个成就感还是挺爽的，对吧？

接下来你可以玩的花样就多了：爬数据、做UI自动化测试、定时截图监控网站变化……这些都是同一个工具能做的事。

如果这篇教程帮到了你，欢迎收藏或转发给身边同样想入门自动化测试的朋友。有问题也可以在评论区留言，看到了都会回。

下一个10分钟，试试把https://www.baidu.com 换成你喜欢的任何网站吧。