PyCharm 2025.3 Help

Selenium

Selenium 是一种广泛使用的开源测试框架,用于自动化 Web 浏览器交互。 该框架支持多种 Web 浏览器和平台,因而适用于全面的 Web 应用测试。

Selenium 支持使您能够为 Java、Kotlin、Groovy 和 Python 自动化测试创建专用项目。 您可以选择 Maven 或 Gradle 来进行依赖项管理。 要管理测试用例,您可以选择 TestNGJUnit

创建新的 Selenium 项目

  1. 在主菜单中,点击 文件 | 新建 | 项目。 或者,在欢迎屏幕的左侧窗格中,点击 新建 | 新建项目

    将打开 新建 项目 对话框

  2. 在左侧的列表中,选择 Selenium 与 Pytest

    创建新的使用 Pytest 的 Selenium 项目
  3. 为新项目命名,并在必要时更改其位置。

  4. (可选)启用 创建Git 仓库 选项,将新项目置于版本控制之下。 如果您现在不想这样做,稍后可随时进行。

  5. 选择是创建新的还是使用现有的 环境 ,并配置相应设置。

    配置新的 Virtualenv 环境
    • 从列表中选择基础解释器,或点击 选择基础解释器 ,在文件系统中找到 Python 可执行文件。

    • 位置 字段中指定新虚拟环境的位置,或点击 虚拟环境位置 在文件系统中浏览该位置。 新虚拟环境的目录应为空。

    • 如果希望将您计算机上全局 Python 中已安装的所有软件包添加到即将创建的虚拟环境中,请选中 从基础解释器继承包 复选框。 该复选框对应 virtualenv 工具的 --system-site-packages 选项。

    • 如果希望在 PyCharm 中创建 Python 解释器时重用此环境,请选中 对所有项目可用 复选框。

    有关详细信息,请参阅 配置 virtualenv 环境

    配置新的 Conda 环境
    • 位置 字段中指定新的 conda 环境的位置,或点击 浏览... 在文件系统中浏览该位置。 新的 conda 环境的目录应为空。

    • 从列表中选择 Python 版本。

    • PyCharm 将检测到 conda 安装。

      如果 PyCharm 未能自动检测到该安装,请指定 conda 可执行文件的位置,或点击 Conda 可执行文件位置 进行浏览。

    有关详细信息,请参阅 配置一个 Conda 虚拟环境

    配置新的 Pipenv 环境
    • 从列表中选择基础解释器,或点击 浏览... ,在文件系统中找到 Python 可执行文件。

    • 如果您已将基础二进制目录添加到环境变量 PATH 中,则无需设置任何其他选项:将自动检测到 pipenv 可执行文件的路径。

      如果 PyCharm 未检测到 pipenv 可执行文件,请点击 通过 pip 安装 pipenv ,允许 PyCharm 为您自动安装它。

      或者,遵循 pipenv 安装过程 来查找可执行文件路径,然后在对话框中进行指定。

    有关详细信息,请参阅 配置 pipenv 环境

    配置新的 Poetry 环境
    • 从列表中选择基础解释器,或点击 浏览... ,在文件系统中找到 Python 可执行文件。

    有关详细信息,请参阅 配置 Poetry 环境

    配置现有环境
    • 从列表中选择解释器。 如果没有可用的解释器,请点击 添加解释器 ,并根据需要进行配置。

  6. 点击 创建

将根据您选择的选项创建新项目。

将元素添加到代码

  1. 打开您要添加元素的文件。

  2. 在右侧侧边栏中点击 Web Inspector 按钮 ,打开 Web 检查器 工具栏窗口。

  3. 在地址栏中指定页面的 URL。

    地址栏控件
  4. 点击 Select Element in Page 按钮 ,并在 Web Inspector 中选择要添加的元素。

    在页面中选择元素
  5. 选择元素后,点击 将元素添加到代码 将该元素添加到代码中。

    Add Element to Code 按钮

    若要添加特定类型的选择器(IDNameTag with classes 等),请点击 按以下方式将元素添加到代码 并选择所需选项。

    按以下方式将元素添加到代码

    如果您想在 CSS 和 XPath 定位器之间进行切换,请点击 并选择所需的定位器类型。

    选择定位器类型

这样会生成一段代码并将其添加到代码编辑器中。

运行测试

  • 要运行测试,请点击测试类或测试方法旁边的装订区域中的 Run 按钮 图标,然后在列表中选择 运行 选项。

    运行测试

    或者,将插入符号置于测试类以运行该类中的所有测试,或置于测试方法,然后按 Ctrl+Shift+F10

您可以使用运行/调试配置以更可定制的方式运行测试。 有关详细信息,请参阅 运行测试

查看测试结果

测试运行结束后,结果将显示在 运行 工具窗口的 测试运行程序 选项卡中。 在此选项卡中,您可以重新运行测试、导出和导入测试结果、查看运行每个测试所花费的时间,并执行其他操作。

在 Run 工具窗口的 Test Runner 选项卡中显示测试结果

有关详细信息,请参阅 浏览测试结果

调试测试

通常,调试过程包括以下步骤:

  1. 为必须暂停执行的代码行设置断点。

  2. 以调试模式运行代码。

  3. 使用 调试 工具窗口来分析代码并定位潜在问题。

  4. 修复问题。

要在 IDE 中重现这些步骤,请执行以下操作:

  1. 在装订区域,将鼠标悬停在您希望暂停执行的可执行代码行上,然后点击

    设置断点
  2. 在装订区域点击 ,并选择 调试。 这将启动调试器会话并运行您的代码。

    启动调试会话
  3. 程序到达断点后,执行将被暂停,您可以在 调试 工具窗口中查看调试器会话的结果。

    调试工具窗口概述

有关调试的详细信息,请参阅 调试

修改运行/调试配置

如果您想修改测试的启动属性,请编辑运行/调试配置:

  1. 在运行/调试配置切换器中点击当前配置,并选择 编辑配置(R)… 选项。

    选择运行/调试配置
  2. 运行/调试配置 对话框中,选择您要编辑的配置。

  3. 配置所需的启动属性。

    配置启动属性
  4. 应用更改并点击 确定

有关运行/调试配置的详细信息,请参阅 运行/调试配置

自定义定位器模板

如果您想自定义所选元素添加到代码的方式,您可以修改模板:

  1. 在状态栏上点击框架名称。 将打开 UI 自动化框架 菜单。

    自定义模板
  2. 选择 自定义模板 选项。

  3. 文件与代码模板 对话框中,从列表中选择所需框架。

    文件和代码模板对话框
  4. 重写 Web 元素定位器的代码生成算法。

  5. 点击 确定 以保存更改。

因此,将根据更新后的代码生成算法将定位器添加到代码中。

使用 Selenoid 进行跨浏览器测试

Selenoid 是面向 Docker 的 Selenium hub 的一种实现,它允许您在运行于 Docker 容器中的 Web 浏览器上执行自动化测试。 对于每个测试,Selenoid 会创建一个包含指定 Web 浏览器、环境和设置的容器。

在 Docker 上运行 Selenoid

  1. 在编辑器中打开 browsers.json 文件。

  2. 在编辑器上方的面板中,点击 启动

    在 Docker 上运行 Selenoid

IDE 将拉取所有所需的包含浏览器的容器,并运行主 Selenoid 容器来管理它们。

在 Selenoid 运行配置 设置中还提供了其他选项,例如日志和视频的输出目标文件夹。 要访问这些选项,请在打开 browsers.json 文件时,在编辑器上方的面板中点击 配置。 有关这些选项的详细说明,请参阅 Docker 运行配置

最后修改日期: 2025年 12月 2日