Mac安装Playwright

你的电脑是 Apple M1 Max 芯片的 Mac，下面是根据你的系统环境，梳理的 Playwright 安装步骤、Python 环境检查方法和版本选择建议。

🐍 如何检查你 Mac 上的 Python 版本与路径

在安装 Playwright 前，可以先在终端（Terminal）里用几个命令摸清当前的 Python 环境。

1. 检查当前默认的 Python 3 版本和路径

这是最重要的一步，能让你知道系统当前优先使用的是哪个 Python。

bash 复制代码

python3 --version
which python3

python3 --version：查看当前默认的 Python 3 版本号。
which python3 ：显示该版本所在的完整路径 。这个路径能帮你判断它的来源：
- /usr/bin/python3：macOS 系统自带的 Python。不建议用作开发环境，因为它无法随意升级。
- /opt/homebrew/bin/python3（Apple Silicon Mac）或 /usr/local/bin/python3（Intel Mac）：通过 Homebrew 安装的 Python。
- ~/.pyenv/shims/python3：通过 pyenv 这个版本管理工具安装的 Python。

2. 查找电脑上所有已安装的 Python 版本和路径

查找所有 python3 的路径 ：使用 -a 参数可以列出 PATH 环境变量中所有名为 python3 的可执行文件路径。
bash 复制代码
```
which -a python3
```
查看特定安装管理工具管理的版本 ：
- Homebrew ：brew list --versions | grep -i python
- pyenv （如果使用）：pyenv versions
查看官方安装包安装的版本 ：通过 Python 官网 .pkg 安装的版本，通常位于这个目录下：
bash 复制代码
```
ls /Library/Frameworks/Python.framework/Versions/
```
这个目录会列出所有通过官方安装包安装的 Python 版本。

🐍 当前最新的 Python 版本是哪个？

根据 Python 官网信息，目前最新的稳定版本是 Python 3.15.0（于2026年10月9日发布）。

🤔 推荐你下载哪个 Python 版本？

推荐安装 Python 3.12 或 3.13 版本。

主要原因如下：

兼容性与稳定性：Playwright 要求 Python 3.8 或更高版本。3.12 和 3.13 都是非常稳定且成熟的版本，社区生态和第三方库的兼容性都很好。
长期支持：Python 3.12 的官方支持会持续到 2028年10月，有足够长的维护周期。
性能与特性：这两个版本在性能上有不错的优化，同时包含了许多现代 Python 特性。
避开最新版：最新的 3.15.0 刚发布不久，第三方库的适配可能还在完善中，对于追求稳定的开发环境来说，现在还不是最佳时机。

如何安装推荐版本？

推荐使用 Homebrew 来安装和管理 Python，这是 Mac 上最省心的方式。

bash 复制代码

# 安装 Python 3.12（或 3.13）
brew install python@3.12

安装后，你可以用 python3.12 或 python3.13 命令来指定使用该版本。

🚀 如何安装 Playwright

Playwright 官方推荐使用其 Pytest 插件 来进行端到端测试，因为它提供了上下文隔离和开箱即用的多浏览器配置。

1. 确认 Python 环境

确保你使用的是推荐的 Python 版本（如 3.12）。可以先用 python3.12 --version 验证一下。

2. 安装 Playwright 及 Pytest 插件

在终端中运行：

bash 复制代码

pip install pytest-playwright

或者，如果你想使用 Playwright 的库模式（手动编写测试逻辑），可以只安装核心库：

bash 复制代码

pip install playwright

3. 安装 Playwright 所需的浏览器内核

这一步会下载 Chromium、Firefox 和 WebKit 浏览器。

bash 复制代码

playwright install

如果下载速度慢，可以尝试设置 Playwright 的下载浏览器内核的镜像，例如：

bash 复制代码

export PLAYWRIGHT_DOWNLOAD_HOST=https://npmmirror.com/mirrors/playwright
playwright install

4. 验证安装（可选但推荐）

创建一个名为 test_example.py 的文件，填入以下官方示例代码：

python 复制代码

import re
from playwright.sync_api import Page, expect

def test_has_title(page: Page):
    page.goto("https://playwright.dev/")
    expect(page).to_have_title(re.compile("Playwright"))

def test_get_started_link(page: Page):
    page.goto("https://playwright.dev/")
    page.get_by_role("link", name="Get started").click()
    expect(page.get_by_role("heading", name="Installation")).to_be_visible()

然后在终端中运行 pytest。如果测试通过，说明 Playwright 环境已配置成功。

💎 总结

总的来说，对于你的 M1 Max Mac，推荐使用 Homebrew 安装 Python 3.12，然后通过 pip install pytest-playwright 和 playwright install 来搭建 Playwright 环境 。

你当前环境的 Python 版本是 3.12.4，这完全满足 Playwright 的要求（需要 3.8+），可以继续使用。如果你想额外安装 Python 3.13 体验新版本，可以通过你已有的 pyenv 来管理，这样不会影响现有的 3.12 环境。

🐍 如何确认当前的 Python 环境？

python --version 的结果 ：Python 3.12.4 表明你的默认 Python 解释器就是 3.12.4 版本。
which python3 的结果 ：/Users/wuwenlu/.pyenv/shims/python3 说明你的 python3 命令由 pyenv 管理，这正是由它来负责切换 Python 版本的。

🛠️ 如何用 pyenv 安装 Python 3.13？

你的 pyenv 环境已经配置好了，可以直接用它来安装 Python 3.13。

查看可安装的版本：先确认 3.13 系列有哪些具体版本可以安装。
bash 复制代码
```
pyenv install --list | grep 3.13
```
执行安装命令 ：选择一个版本号（例如 3.13.2）进行安装。这个过程需要下载源码并编译，可能需要一些时间。
bash 复制代码
```
pyenv install 3.13.2
```
验证安装 ：安装完成后，查看 pyenv 管理的所有版本，确认 3.13 已经就绪。
bash 复制代码
```
pyenv versions
```
（可选）设置默认版本：如果你希望默认使用 3.13，可以执行以下命令，但这会改变你当前全局的 Python 版本。
bash 复制代码
```
pyenv global 3.13.2
```

提示：安装过程中如果遇到编译错误，通常是因为缺少 openssl、readline 等依赖库，可以尝试先通过 Homebrew 安装这些依赖。

🔧 如何配置 pip 镜像并安装 Playwright？

你老师提供的 pip config set 命令是正确的。下面是你可以在终端中直接执行的完整命令序列：

bash 复制代码

# 1. 配置 pip 使用阿里云镜像源，加速下载
pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/

# 2. 升级 pip 到最新版本
pip install --upgrade pip

# 3. 安装 Playwright 库
pip install playwright

# 4. 设置 Playwright 浏览器内核的下载镜像（重要，可避免下载超时）
export PLAYWRIGHT_DOWNLOAD_HOST=https://npmmirror.com/mirrors/playwright

# 5. 安装 Playwright 所需的浏览器内核playwright install 默认会下载 Playwright 支持的全部浏览器内核，包括 Chromium、Firefox 和 WebKit。
playwright install

注意：第 4 步的 export 命令只在当前终端会话中有效。如果想永久生效，需要将 export PLAYWRIGHT_DOWNLOAD_HOST=... 这行命令添加到你的 ~/.zshrc 文件中。

💎 总结

你目前的环境可以直接开始 Playwright 的安装流程。关于 Python 3.13，通过 pyenv 安装是一个很好的选择，能让你在不影响现有项目的前提下，灵活地管理和切换不同版本。