ARTICLE DETAIL

建站实战干货

来自一线的建站与推广经验沉淀,每一条都经过真实交付验证。

Playwright 如何用 PLAYWRIGHT_BROWSERS_PATH 自定义浏览器二进制的下载与安装位置?

2026/9/9 21:37:12 拓冰建站 浏览量
Playwright 如何用 PLAYWRIGHT_BROWSERS_PATH 自定义浏览器二进制的下载与安装位置? Playwright 如何用 PLAYWRIGHT_BROWSERS_PATH 自定义浏览器二进制的下载与安装位置【免费下载链接】playwrightPlaywright is a framework for Web Testing and Automation. It allows testing Chromium, Firefox and WebKit with a single API.项目地址: https://gitcode.com/GitHub_Trending/pl/playwright用 Playwright CLI 安装浏览器后浏览器二进制默认落在操作系统的缓存目录里Windows 上是%USERPROFILE%\AppData\Local\ms-playwrightmacOS 上是~/Library/Caches/ms-playwrightLinux 上是~/.cache/ms-playwright装完会占用几百 MB 磁盘。如果你希望把浏览器下载并安装到指定目录——比如共享给多个 Playwright 版本或放进项目的node_modules里随项目走——只需在安装和运行测试前设置PLAYWRIGHT_BROWSERS_PATH环境变量。本文的操作依据是仓库中的浏览器文档。准备确认当前浏览器装在哪里先确认默认目录里的浏览器版本和占用空间。macOS/Linux 上可以用文档给出的方式查看各浏览器目录的大小以下输出为文档示例实际数值因版本而异du -hs ~/Library/Caches/ms-playwright/* 281M chromium-XXXXXX 187M firefox-XXXX 180M webkit-XXXX注意一个前提每个版本的 Playwright 对应特定版本的浏览器二进制升级 Playwright 后往往需要重新运行install。这也是自定义安装目录的主要动机之一——把浏览器放在自己管理的位置方便跨版本共享和清理。安装时指定目录PLAYWRIGHT_BROWSERS_PATH主路径以 JS 绑定 bash 为例$HOME/pw-browsers是文档中的示例路径替换成你实际想要的目录即可PLAYWRIGHT_BROWSERS_PATH$HOME/pw-browsers npx playwright installWindows 上对应写法cmd 与 PowerShell 各一种set PLAYWRIGHT_BROWSERS_PATH%USERPROFILE%\pw-browsers npx playwright install$Env:PLAYWRIGHT_BROWSERS_PATH$Env:USERPROFILE\pw-browsers npx playwright install其他语言绑定使用同一个环境变量只是安装命令换成各自的 CLI# Python pip install playwright PLAYWRIGHT_BROWSERS_PATH$HOME/pw-browsers python -m playwright install# Java PLAYWRIGHT_BROWSERS_PATH$HOME/pw-browsers mvn exec:java -e -D exec.mainClasscom.microsoft.playwright.CLI -D exec.argsinstall# .NET PLAYWRIGHT_BROWSERS_PATH$HOME/pw-browsers pwsh bin/Debug/netX/playwright.ps1 install如果希望本机所有终端都生效文档建议把PLAYWRIGHT_BROWSERS_PATH$HOME/pw-browsers的 export 语句写进.bashrc。运行脚本与测试时也指向同一目录环境变量只对设置它的进程生效所以后续运行 Playwright 时同样要带上它Playwright 才会到这个共享位置查找浏览器# JS PLAYWRIGHT_BROWSERS_PATH$HOME/pw-browsers npx playwright test # Python PLAYWRIGHT_BROWSERS_PATH$HOME/pw-browsers python playwright_script.py # Java PLAYWRIGHT_BROWSERS_PATH$HOME/pw-browsers mvn test # .NET PLAYWRIGHT_BROWSERS_PATH$HOME/pw-browsers dotnet test如果已经按上一节把变量写进了.bashrc日常执行就不再需要每次手动前缀变量。验证安装位置是否生效文档提供的检查方式是列出机器上所有 Playwright 安装使用的浏览器npx playwright install --list该命令会打印出所有 Playwright 安装位置中的浏览器清单。另外可以用与上文相同的方式查看目标目录确认浏览器目录确实落在那里du -hs $HOME/pw-browsers/*最后用同一环境变量跑一次测试如PLAYWRIGHT_BROWSERS_PATH$HOME/pw-browsers npx playwright test测试能正常启动浏览器即说明运行侧也指向了该目录。可选用 PLAYWRIGHT_BROWSERS_PATH0 做 hermetic 安装JS 侧有一个特殊取值把PLAYWRIGHT_BROWSERS_PATH设为0时二进制会放到本地目录node_modules/playwright-core/.local-browsers随项目而不是随用户目录走# Places binaries to node_modules/playwright-core/.local-browsers PLAYWRIGHT_BROWSERS_PATH0 npx playwright installPython 侧的 library-python 文档 给出了一个配套场景用 PyInstaller 打独立可执行文件时希望把浏览器一并打包进去PLAYWRIGHT_BROWSERS_PATH0 playwright install chromium pyinstaller -F main.py文档提醒打包浏览器会生成更大的可执行文件建议只打包实际用到的浏览器所以上例只安装了chromium。限制与维护不影响品牌浏览器文档明确说明PLAYWRIGHT_BROWSERS_PATH不改变 Google Chrome 和 Microsoft Edge 的安装位置这两个品牌浏览器安装在操作系统的全局默认位置。自动清理GCPlaywright 会记录哪些包需要这些浏览器当你升级到更新的 Playwright 版本时不再被任何客户端使用的旧版本浏览器会被自动删除。如果不想清理可设置PLAYWRIGHT_SKIP_BROWSER_GC1或给安装命令加--no-removenpx playwright install --no-remove卸载确认不再需要时npx playwright uninstall会移除当前 Playwright 安装对应的 chromium、firefox、webkit 浏览器此命令会实际删除浏览器文件执行前确认目录里没有你自己放进去的东西加--all则会连带移除机器上其他 Playwright 安装的浏览器。浏览器装进指定目录、--list能看到对应版本、测试在该目录下正常启动这一套路径就走完了。【免费下载链接】playwrightPlaywright is a framework for Web Testing and Automation. It allows testing Chromium, Firefox and WebKit with a single API.项目地址: https://gitcode.com/GitHub_Trending/pl/playwright创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考