# Selenium

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com.cn/help/idea/llms.txt).

> **Note:**
> IntelliJ IDEA 中对 Selenium 的支持由 [Test Automation](https://plugins.jetbrains.com/plugin/20175-test-automation) 插件提供，本节所述的大多数功能都依赖于该插件。 但是，像运行和调试 Selenium 测试这样基本的功能无需插件也能正常工作。

![](https://resources.jetbrains.com.cn/help/img/idea/2026.3/aqua-plugin.icons.selenium.svg) [Selenium](https://www.selenium.dev/) 是一个广泛使用的开源测试框架，用于自动化网络浏览器交互。 该框架支持各种网络浏览器和平台，使其能够进行全面的 Web 应用程序测试。

Selenium 支持允许您创建一个专门用于 Java、Kotlin、Groovy 和 Python 自动化测试的项目。 您可以选择 Maven 或 Gradle 来进行依赖管理。 要管理测试用例，您可以选择 [TestNG](testng.html) 或 [JUnit](junit.html)。

## 创建一个新的 Selenium 项目

Selenium:

Procedure:

1. 在主菜单中，前往  `文件 | 新建 | 项目` 。 或者，如果您在   欢迎  屏幕上，请点击   新建项目  。

2. 在左侧列表中，选择   Selenium  。

![创建一个新的 Selenium 项目](https://resources.jetbrains.com.cn/help/img/idea/2026.3/selenium-new-project.png)

3. 为新项目命名，并在必要时更改其位置。

4. （可选）启用   创建 Git 仓库   选项，将新项目置于版本控制之下。 如果现在不想执行此操作，稍后可随时进行。

5. 请选择您要使用的   语言  。

6. 请选择您希望在项目中使用的构建系统： [Maven](maven-support.html)或 [Gradle](gradle.html)。

7. 请选择 您 要用于测试用例管理的测试框架： [JUnit](junit.html) 或 [TestNG](testng.html)。

8. （可选）修改   组   和   工件   参数。

9. 从    JDK    列表中选择您想在项目中使用的 [JDK](sdk.html#jdk)。

* 如果已在计算机上安装 JDK，但未在 IDE 中定义，请选择 ![](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.nodes.jdk.png) 从磁盘添加 JDK… 并指定 JDK 主目录的路径。​

* 如果您的计算机上没有必要的 JDK，请选择 ![](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.general.download.svg) 下载 JDK 。

10. （可选）启用   添加示例代码   参数。

11. 点击   下一步  。

12. 选择您想使用的 Selenium 版本，并添加所需的依赖项。

![添加依赖项](https://resources.jetbrains.com.cn/help/img/idea/2026.3/selenium_new_project_dependencies.png)

13. 点击   创建  。

使用 Pytest 的 Selenium:

Procedure:

> **Note:**
> 只有在 [Python 插件](https://plugins.jetbrains.com/plugin/631-python) [已安装并启用](managing-plugins.html)的情况下，才能创建   使用 Pytest 的 Selenium   项目。

1. 点击   新建项目   屏幕上的   欢迎   或从主菜单中选择  `文件 | 新建 | 项目` 。 将打开 [新建 项目 对话框](null)。

2. 在左侧列表中，选择   使用 Pytest 的 Selenium  。

![创建新的 Selenium 与 Pytest 项目](https://resources.jetbrains.com.cn/help/img/idea/2026.3/ij_selenium_pytest_virtualenv.png)

3. 为新项目命名，并在必要时更改其位置。

4. （可选）启用   创建 Git 仓库   选项，将新项目置于版本控制之下。 如果现在不想执行此操作，稍后可随时进行。

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

新建:

Virtualenv:

![创建新的 Selenium 与 Pytest 项目](https://resources.jetbrains.com.cn/help/img/idea/2026.3/ij_selenium_pytest_virtualenv.png)

* 从列表中选择基础解释器，或者点击 ![选择基础解释器](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.inline.browse.svg) 并在文件系统中找到 Python 可执行文件。

* 在 位置 字段中指定新虚拟环境的位置，或者点击 ![虚拟环境位置](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.inline.browse.svg) 并在文件系统中浏览该位置。 新虚拟环境的目录应为空。

* 如果希望将计算机上全局 Python 中安装的所有软件包添加到将要创建的虚拟环境中，请选择 从基础解释器继承软件包 复选框。 此复选框对应 `--system-site-packages` 选项的 [virtualenv](http://www.virtualenv.org/en/latest/index.html) 工具。

有关详细信息，请参阅 [PyCharm 文档](https://www.jetbrains.com.cn/help/pycharm/creating-virtual-environment.html)。

Conda:

![配置新的 Conda 环境](https://resources.jetbrains.com.cn/help/img/idea/2026.3/ij_selenium_pytest_conda.png)

* 在 位置 字段中指定新 Conda 环境的位置，或者点击 ![浏览…](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.inline.browse.svg) 并在文件系统中浏览该位置。 新 conda 环境的目录应为空。

* 从列表中选择 Python 版本。

* IntelliJ IDEA 将检测到 conda 安装。 如果 IntelliJ IDEA 未自动检测到该安装，请指定 conda 可执行文件的位置，或点击 ![Conda 可执行文件位置](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.inline.browse.svg) 进行浏览。

有关详细信息，请参阅 [PyCharm 文档](https://www.jetbrains.com.cn/help/pycharm/conda-support-creating-conda-virtual-environment.html)。

Pipenv:

![配置一个新的 Pipenv 环境](https://resources.jetbrains.com.cn/help/img/idea/2026.3/ij_selenium_pytest_pipenv.png)

* 从列表中选择基础解释器，或者点击 ![浏览…](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.inline.browse.svg) 并在文件系统中找到 Python 可执行文件。

* 如果您已将基础二进制目录添加到您的 `路径` 环境变量中，则无需设置任何其他选项：pipenv 可执行文件的路径将自动检测。 如果 IntelliJ IDEA 未检测到 pipenv 可执行文件，请点击 通过 pip 安装 pipenv 以允许 IntelliJ IDEA 自动为您安装。 或者，按照 [pipenv 安装过程](null)来查找可执行文件路径，然后在对话框中指定该路径。

有关详细信息，请参阅 [PyCharm 文档](https://www.jetbrains.com.cn/help/pycharm/pipenv.html)。

Poetry:

![配置一个新的 Poetry 环境](https://resources.jetbrains.com.cn/help/img/idea/2026.3/ij_selenium_pytest_poetry.png)

* 从列表中选择基础解释器，或者点击 ![浏览…](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.inline.browse.svg) 并在文件系统中找到 Python 可执行文件。

有关详细信息，请参阅 [PyCharm 文档](https://www.jetbrains.com.cn/help/pycharm/poetry.html)。

现有:

![配置现有环境](https://resources.jetbrains.com.cn/help/img/idea/2026.3/ij_selenium_pytest_existing_env.png)

* 从列表中选择解释器。 如果没有可用的解释器，请点击 添加解释器 ，并根据需要配置一个。

6. 点击   创建  。

将根据所选选项创建一个新项目。

## 添加元素到代码

Procedure:

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

2. 在右侧边栏点击 ![Web Inspector 按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/aqua-plugin.icons.webInspector%4020x20.svg) 以打开   Web 检查器   工具栏窗口。

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

![地址栏控件](https://resources.jetbrains.com.cn/help/img/idea/2026.3/aqua_address_bar_controls.png)

4. 点击 ![页面中选择元素按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/aqua-plugin.icons.browser.expui.selectWeb.svg)，然后在 Web Inspector 中选择要添加的元素。

![选择页面中的元素](https://resources.jetbrains.com.cn/help/img/idea/2026.3/aqua_select_element_in_page.png)

5. 选择元素后，点击 ![将元素添加到代码中。呵 wait alt no period? Need no period for UI label. ](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.add.svg) 将该元素添加到代码。

![“将元素添加到代码”按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/aqua_add_element_to_code.png)

要添加特定类型的选择器（  ID 、  名称 、  带类的标记  等），请点击 ![按以下方式将元素添加到代码](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.general.chevronDownLarge.svg) 并选择所需选项。

![按以下方式将元素添加到代码](https://resources.jetbrains.com.cn/help/img/idea/2026.3/aqua_add_elements_to_code_by.png)

如果想专门在 CSS 和 XPath 定位器之间切换，请点击 ![](https://resources.jetbrains.com.cn/help/img/idea/2026.3/aqua-plugin.icons.locators.expui.css.svg) 并选择所需的定位器类型。

![选择定位器类型](https://resources.jetbrains.com.cn/help/img/idea/2026.3/aqua_locator_type_switcher.png)

因此，将生成一段代码并将其添加到代码编辑器中。

## 运行测试

Procedure:

* 要运行测试，请点击测试类或测试方法旁的 ![运行按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.gutter.run.svg) 装订区域图标，然后在列表中选择   运行   选项。

![运行测试](https://resources.jetbrains.com.cn/help/img/idea/2026.3/aqua_run_tests.png)

或者，将文本光标置于测试类处以运行该类中的所有测试，或置于测试方法处，然后按 `Ctrl+Shift+F10` (Windows), `⌃ ⇧ R` (macOS), `⌃ ⇧ F10` (IntelliJ IDEA Classic (macOS)), `⌃ ⇧ R` (macOS System Shortcuts), `Ctrl+Shift+F10` (XWin), `Ctrl+Shift+F10` (GNOME), `Ctrl+Shift+F10` (KDE), `Ctrl+Shift+F10` (Emacs), `Ctrl+Shift+F10` (Sublime Text), `Ctrl+Shift+F10` (Sublime Text (macOS)), `Ctrl+Alt+F5` (Visual Studio), `⌃ ⌥ F5` (Visual Studio (macOS)), `Alt+Shift+F6` (NetBeans), `Ctrl+Shift+F10` (Eclipse), `⌃ ⇧ R` (Eclipse (macOS))。

可以使用运行/调试配置，以更可自定义的方式运行测试。 有关更多信息，请参见 [运行测试](performing-tests.html)。

## 查看测试结果

测试运行完成后，结果会显示在   运行   工具窗口的   测试运行器   选项卡上。 在此选项卡上，可以重新运行测试、导出和导入测试结果、查看每个测试的运行耗时以及执行其他操作。

![显示在运行工具窗口的测试运行程序选项卡上的测试结果](https://resources.jetbrains.com.cn/help/img/idea/2026.3/aqua_selenium_review_tests.png)

有关更多信息，请参见 [浏览测试结果](viewing-and-exploring-test-results.html)。

## 调试测试

一般来说，调试过程包括以下步骤：

1.  为需要暂停执行的代码行设置断点。

2.  在调试模式下运行您的代码。

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

4.  修复问题。

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

Procedure:

1. 在装订区域，将鼠标悬停在想要暂停执行的可执行代码行上，然后点击 ![](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.breakpoints.breakpoint.svg)。

![设置断点](https://resources.jetbrains.com.cn/help/img/idea/2026.3/aqua_selenium_set_breakpoints.png)

2. 在装订区域中点击 ![](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.run.run.svg) 并选择   调试  。 这将启动调试器会话并运行您的代码。

![开始调试会话](https://resources.jetbrains.com.cn/help/img/idea/2026.3/aqua_run_tests.png)

3. 程序命中断点后，执行将被挂起，可以在   调试   工具窗口中查看调试器会话的结果。

![调试工具窗口概述](https://resources.jetbrains.com.cn/help/img/idea/2026.3/aqua_selenium_debug_tool_window.png)

有关调试的详细信息，请参阅 [调试代码](debugging-code.html)。

## 修改运行/调试配置

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

Procedure:

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

![选择运行/调试配置](https://resources.jetbrains.com.cn/help/img/idea/2026.3/aqua_selenium_edit_run_debug_config.png)

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

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

![配置启动属性](https://resources.jetbrains.com.cn/help/img/idea/2026.3/调试配置](run-debug-configuration.html)。

## 自定义定位器模板

如果想自定义将选定元素添加到代码的方式，可以修改模板：

Procedure:

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

![自定义模板](https://resources.jetbrains.com.cn/help/img/idea/2026.3/aqua_customize_template.png)

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

3. 在   文件和代码模板   对话框中，从列表中选择所需的框架。

![文件和代码模板对话框](https://resources.jetbrains.com.cn/help/img/idea/2026.3/aqua_selenium_locator_template.png)

4. 重写 Web 元素定位器的代码生成算法。

> **Tip:**
> 使用 [Apache Velocity](https://velocity.apache.org/) 模板语言。

5. 点击   OK   以保存更改。

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

## 使用 Selenoid 进行跨浏览器测试

![](https://resources.jetbrains.com.cn/help/img/idea/2026.3/aqua-plugin.icons.selenoid.svg) [Selenoid](https://aerokube.com/selenoid/latest/) 是 Selenium hub 在 Docker 上的实现，允许您在 Docker 容器中运行的网络浏览器上执行自动化测试。 对于每个测试，Selenoid 会创建一个包含指定网络浏览器、环境和设置的容器。

Procedure: 在 Docker 上运行 Selenoid

> **Note:**
> 要使此功能正常工作，您必须先在您的 IDE 中配置 Docker。 如需更多信息，请参阅 [Docker](docker.html)。

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

2. 在编辑器上方的面板上，点击   启动  。

![在 Docker 上运行 Selenoid](https://resources.jetbrains.com.cn/help/img/idea/2026.3/run-on-docker.png)

IDE 将拉取所有带有浏览器的必需容器，并运行主 Selenoid 容器来管理它们。

在 Selenoid [run configuration](run-debug-configuration.html) 设置中有额外的选项，如日志和视频的输出目标文件夹。 要访问这些选项，请在打开  `browsers.json` 文件时点击编辑器上方窗格中的   配置  。 欲了解选项的详细说明，请参阅 [Docker 运行配置](docker-run-configurations.html)。

## See also

### 过程

[Docker](docker.html)

### 外部链接

[Selenium](https://www.selenium.dev/) [Aerokube Selenoid](https://aerokube.com/selenoid/)

