Python Playwright在线与离线安装完整指南

陈默

发布时间：2026-10-13 | 4人浏览过

原创

本文详细讲解Python中Playwright库的在线与离线安装方法。在线安装需确保网络通畅，通过pip install playwright及playwright install命令完成。离线安装则推荐先使用pip download下载完整依赖包，再在目标设备执行pip install。针对内置浏览器，可通过--dry-run查看路径，手动下载解压后创建INSTALLATION_COMPLETE文件以完成离线部署。

在线安装

前提条件：

确保网络环境稳定，能够正常访问并下载所有必需的依赖库。

1、安装playwright

pip install playwright

2、playwright安装内置浏览器

playwright install

离线安装

1、离线包下载

首先在一台联网电脑上获取playwright安装包。请注意，不要仅从pypi库单独下载这一个包，因为安装过程中还会涉及其他依赖包的下载。如果只下载playwright-1.58.0-py3-none-win_amd64.whl然后通过pip安装，通常会失败。正确的做法是通过执行pip download playwright命令来下载安装包。

pip download playwright -d ./playwright

-d 参数用于指定将下载的安装包保存到本地down目录。

正常情况下，该操作会下载以下四个主要包。

2、安装playwright

将之前下载的离线包传输到目标设备中，然后在离线包所在的目录下执行以下指令进行离线安装。

pip install playwright-1.58.0-py3-none-manylinux1_x86_64.whl

安装结果如图所示：

3、安装内置浏览器

执行以下指令以查看内置浏览器的下载路径和安装路径。

playwright install --dry-run

结果如下，Install location字段展示了对应的安装路径，Download url为对应的下载路径。你可以分别根据查到的下载路径在有网络的设备上进行文件下载，下载完毕后，将对应文件解压在对应的安装目录（主要是目录名称）。

解压指令如下：

unzip -d /home/luke/.cache/ms-playwright/chromium-1208 chrome-linux64.zip
unzip -d /home/luke/.cache/ms-playwright/chromium_headless_shell-1208 chrome-headless-shell-linux64.zip
unzip -d /home/luke/.cache/ms-playwright/firefox-1509 firefox-ubuntu-24.04.zip
unzip -d /home/luke/.cache/ms-playwright/webkit-2248 webkit-ubuntu-24.04.zip
unzip -d /home/luke/.cache/ms-playwright/ffmpeg-1011 ffmpeg-linux.zip

当以上文件都解压完毕后，再执行以下指令为每个目录创建一个空的INSTALLATION_COMPLETE文件。该文件用于标识该目录下载完成，否则在进行安装时程序会删除你离线解压的目录然后再次进行下载安装。

# 创建空的INSTALLATION_COMPLETE文件
echo >> /home/luke/.cache/ms-playwright/chromium-1208/INSTALLATION_COMPLETE
echo >> /home/luke/.cache/ms-playwright/chromium_headless_shell-1208/INSTALLATION_COMPLETE
echo >> /home/luke/.cache/ms-playwright/firefox-1509/INSTALLATION_COMPLETE
echo >> /home/luke/.cache/ms-playwright/webkit-2248/INSTALLATION_COMPLETE
echo >> /home/luke/.cache/ms-playwright/ffmpeg-1011/INSTALLATION_COMPLETE

# 安装内置浏览器
playwright install

至此，playwright安装完毕，您可以开始使用了。