type
status
date
summary
slug
tags
category
Created time
Jun 4, 2025 08:24 AM
icon
password
作为一名经常使用 Playwright 进行自动化测试的开发者，你是否遇到过这样的困扰：每次运行测试脚本时，Playwright 都要重新下载几百 MB 的浏览器文件，不仅浪费时间，还消耗大量带宽？特别是在网络环境不佳的情况下，这简直是开发者的噩梦！
今天，我将分享一个简单而有效的解决方案，让你彻底告别重复下载的烦恼，让 Playwright 的运行速度飞起来！
<!-- truncate -->
痛点分析：为什么 Playwright 总是重复下载？
在深入解决方案之前，我们先来理解问题的根源。
默认行为的问题
Playwright 默认会将浏览器二进制文件下载到系统的临时目录或用户目录下的特定位置。在某些情况下，这些文件可能会被清理或者 Playwright 无法正确识别已下载的浏览器，导致重复下载。
常见触发场景
- **项目切换**：在不同项目间切换时
- **环境清理**：系统清理临时文件后
- **版本更新**：Playwright 版本更新后
- **权限问题**：文件权限导致的访问失败
这些问题不仅影响开发效率，在 CI/CD 环境中更是资源浪费的重灾区。
核心解决方案：PLAYWRIGHT_BROWSERS_PATH
解决这个问题的关键在于使用 `PLAYWRIGHT_BROWSERS_PATH` 环境变量，它允许我们指定浏览器的存储位置，确保 Playwright 能够找到并重用已下载的浏览器。
方案优势
- **一次下载，永久使用**：浏览器文件存储在指定位置，不会被意外清理
- **项目间共享**：多个项目可以共享同一套浏览器文件
- **可控管理**：明确知道浏览器文件的存储位置，便于管理
- **CI/CD 友好**：可以在构建环境中缓存浏览器文件
实战配置步骤
步骤 1：选择存储目录
首先，选择一个合适的目录来存储浏览器文件。推荐几种方案：
**方案 A：项目级存储**
**方案 B：全局存储**
**方案 C：自定义路径**
步骤 2：永久设置环境变量
为了避免每次都要手动设置环境变量，将其添加到 Shell 配置文件中：
**对于 zsh 用户（macOS 默认）：**
**对于 bash 用户：**
步骤 3：安装浏览器
设置好环境变量后，运行安装命令：
步骤 4：验证配置
检查浏览器是否正确安装到指定目录：
你应该能看到类似这样的输出：
高级优化技巧
技巧 1：使用系统已安装的 Chrome
如果你的系统已经安装了 Google Chrome，可以直接使用它，无需下载额外的 Chromium：
技巧 2：项目级配置文件
在项目根目录创建 `.env` 文件：
性能对比测试
让我们来看看优化前后的性能差异：
优化前
- **首次运行**：下载时间 2-5 分钟（取决于网络）
- **后续运行**：仍需下载，每次 2-5 分钟
- **存储空间**：可能存在多份重复文件
优化后
- **首次运行**：下载时间 2-5 分钟（一次性）
- **后续运行**：秒级启动
- **存储空间**：单份文件，多项目共享
**效率提升：95% 以上的时间节省！**
故障排除指南
问题 1：环境变量不生效
**症状**：设置了环境变量但 Playwright 仍然重复下载
**解决方案**：
问题 2：权限问题
**症状**：无法写入指定目录
**解决方案**：
问题 3：浏览器版本不匹配
**症状**：Playwright 提示浏览器版本不兼容
**解决方案**：
最佳实践建议
1. 目录结构规划
2. 定期清理
虽然我们要避免重复下载，但也要定期清理不再使用的旧版本：
3. 团队协作
在团队项目中，建议：
- 将 `PLAYWRIGHT_BROWSERS_PATH` 配置写入项目文档
- 使用相对路径（如 `./pw-browsers`）便于团队成员使用
- **显著提升开发效率**：节省 95% 以上的等待时间
- **优化存储空间使用**：避免重复文件，支持多项目共享
- **改善 CI/CD 性能**：通过缓存机制加速构建流程
这个看似简单的配置改动，却能带来巨大的效率提升。特别是对于频繁进行自动化测试的开发团队来说，这绝对是一个值得立即实施的优化方案。
现在就试试这个方法，让你的 Playwright 开发体验焕然一新吧！再也不用为漫长的浏览器下载时间而烦恼了。