Playwright安装避坑指南|跟着做,1小时跑通第一个脚本

配套系列：《Playwright 7天实战训练营》系列的 Day1源码包：星球源码包08（Day1-Day7全部代码+README+Q&A）

🎯 Day1 目标

今天你将做到：在自己电脑上，跑通第一个Playwright自动化脚本。

不需要任何自动化测试经验，会装软件就行。

⚡ 先避三个坑

很多人学Playwright，第一步就卡住了。最常见的三个坑：

坑	症状	一句话解法
Python版本不对	报错 `SyntaxError` 或装不上	装 Python 3.8 以上
浏览器没装	报错 `Executable doesn't exist`	运行 `playwright install`
网络超时	pip install 卡住不动	换国内镜像源

记住这三个，下面一个一个解决。

第一步：装Python

如果你已经装了Python：打开终端，运行 python --version，版本 ≥ 3.8 就跳过这步。

如果你没装：

1. 去 python.org 下载
2. 安装时勾选 "Add Python to PATH"（Windows必勾！）
3. 装完打开终端，输入：

python --version

看到 Python 3.x.x 就对了。

Mac用户：也可以用 Homebrew：

brew install python3

第二步：装Playwright

打开终端，依次运行两条命令：

# 安装Playwright库pip install playwright# 安装浏览器（Chromium/Firefox/WebKit）playwright install

第二条命令会下载浏览器，需要1-3分钟，耐心等。

网络慢？换镜像

如果 pip install 卡住了，先换国内镜像：

pip install playwright -i https://pypi.tuna.tsinghua.edu.cn/simple

第三步：跑通第一个脚本

创建一个文件 hello_playwright.py，复制以下代码：

from playwright.sync_api import sync_playwrightwith sync_playwright() as p:    # 打开浏览器    browser = p.chromium.launch(headless=False)    page = browser.new_page()    # 打开SauceDemo练习网站    page.goto("https://www.saucedemo.com")    # 输入用户名和密码    page.fill("#user-name", "standard_user")    page.fill("#password", "secret_sauce")    # 点击登录按钮    page.click("#login-button")    # 打印页面标题，确认登录成功    print("登录成功！" if "Swag Labs" in page.title() else "登录失败")    print(page.title())    # 关闭浏览器    browser.close()

运行：

python hello_playwright.py

如果一切正常，你会看到：

1. 浏览器自动打开，显示SauceDemo登录页
2. 自动填入用户名密码，点击登录
3. 终端打印「登录成功！」和商品列表页标题
4. 浏览器自动关闭

💡 SauceDemo是专门给测试人员用的练习网站，不需要注册，直接用 standard_user / secret_sauce 登录。后面7天我们一直用这个网站，不用切换。

🎉 恭喜！你的第一个Playwright脚本跑通了！

🔧 常见报错速查表

报错信息	原因	解决
`playwright: command not found`	没装浏览器	运行 `playwright install`
`Executable doesn't exist at ...`	浏览器没下载完	重新运行 `playwright install`
`ModuleNotFoundError: No module named 'playwright'`	pip没装成功	重新 `pip install playwright`
`python不是内部或外部命令`	Python没加PATH	重装Python，勾选Add to PATH
`SyntaxError: invalid syntax`	Python版本太低	升级到3.8+
`pip install 超时`	网络问题	换清华镜像源

📝 今日作业

1. ✅ 跑通上面的脚本
2. 🔧 把用户名改成 locked_out_user，看看会报什么错
3. 💡 尝试把 headless=False 改成 headless=True，看看有什么区别

🔑 今天学到了什么

知识点	要点
Python环境	3.8以上，记得加PATH
安装Playwright	pip install + playwright install 两步
第一个脚本	launch → new_page → goto → fill → click
headless模式	False=看浏览器，True=后台跑

❓ 常见问题（安装篇）

Q: `pip install playwright` 卡住不动了？

大概率是在下载浏览器。打开另一个终端窗口取消（Ctrl+C），然后单独安装：

playwright install --with-deps chromium

Q: `playwright install` 一直失败，提示网络错误？

三个方案按顺序试：①设代理 ②手动下载浏览器压缩包放到 ~/.cache/ms-playwright/ 目录 ③只装chromium：playwright install chromium

Q: 提示 `Executable doesn't exist at ...`？

浏览器没装好。删掉缓存重新来：

rm -rf ~/.cache/ms-playwrightplaywright install chromium

Q: `from playwright.sync_api import *` 报错找不到模块？

Playwright 没装好，三步缺一不可：

pip uninstall playwrightpip install playwrightplaywright install chromium

Q: 怎么验证安装成功了？

一行命令验证：

python -c "from playwright.sync_api import sync_playwright; p = sync_playwright().start(); b = p.chromium.launch(); print('✅ 安装成功!'); b.close(); p.stop()"

🚀 Day2预告

今天我们只是"让浏览器自己动起来"，但所有操作都是硬编码——page.fill("#user-name", ...) 里的 #user-name 怎么来的？如果页面上有10个按钮，怎么精准点到你要的那个？

明天我们学元素定位——找到页面上的按钮、输入框、链接，是写自动化用例的基础。

想要源码包+答疑？

公众号文章讲思路，动手练习才是关键。

星球有配套源码包，下载直接跑，还有答疑区，遇到问题随时问。

加入 欢乐马自动化测试实战 知识星球，陪你在自动化测试这条路上走得更稳、更快，支持7天无理由退款。

本文是「Playwright 7天实战训练营」Day1，适合0基础小白按顺序学习。关注公众号，每天一篇，7天从0到能独立做项目。