# Selenium 页面对象

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

> **Note:**
> IntelliJ IDEA中对 Selenium Page Object 的支持由 [Test Automation](https://plugins.jetbrains.com/plugin/20175-test-automation)插件提供。 如果相关功能不可用，请确保插件 [已安装并启用](ui-test-automation.html#install_test_automation_plugin)。

Page Object 是 Selenium 中的一种设计模式，用于建立存储 web 元素的对象库。 其目的是减少代码重复并提高测试用例的可维护性。

典型工作流程从为要测试的 web 页面创建 Page Object 类开始。 然后将定位器和用于与该页面上的元素交互的方法填充到此页面对象类中。 设置好 Page Object 后，可以在测试脚本中引用这些方法，以在 web 页面上执行操作。

## 创建页面对象

Procedure:

> **Note:**
> 在创建页面对象之前，请确保 Selenium 库已添加到类路径中。 否则，该功能将不可用。

1. 在   项目  工具窗口中，右键点击您要存储 Page Object 的目录，然后选择  `新建 | Selenium 页面对象` 。

2. 请选择实现语言、框架，并为 Page Object 命名。

3. （可选）提供您正在为其创建 Page Object 的网页的 URL。

![新的 Selenium 页面对象](https://resources.jetbrains.com.cn/help/img/idea/2026.3/new_selenium_page_object.png)

> **Tip:**
> 如果已配置，指定的网页将在页面对象创建后在   Web 检查器  中打开。 然后您可以继续将所需元素添加到 Page Object。

4. （可选）如果需要，您可以自定义页面对象模板。 有关更多信息，请参见 [自定义 Page Object 模板](#customize_template)。

5. 点击  确定 。

因此，创建了一个新的 Page Object。

## 向页面对象添加元素

Procedure:

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

2. 请在地址栏中指定页面的 URL。 如果您在 [上一步](#create_page_object)中提供了 URL，这一步是可选的。

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

3. 点击 ![页面中选择元素按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/aqua-plugin.icons.browser.expui.selectWeb.svg) 并在   Web 检查器   中选择您要添加到 Page Object 的元素。

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

4. 选择元素后，点击 ![将元素添加到代码中。呵 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)

因此，将生成一段代码并将其添加到代码编辑器中。 重复这些步骤以填充 Page Object 中的其他元素。

## 更改现有 Page Object 中的 URL

如果您想为 Page Object 指定不同的网页 URL，请在  `// page_url`  注释中更新页面地址。

![编辑 Page Object](https://resources.jetbrains.com.cn/help/img/idea/2026.3/aqua_edit_page_object.png)

> **Tip:**
> 对于 FluentLenium，请使用  `@PageUrl` 注解。

## 自定义 Page Object 模板

如果您想自定义 Page Object 文件的默认内容（例如，导入额外的类），请修改 Page Object 模板：

Procedure:

1. 按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))，然后选择  `编辑器 | 文件和代码模板` 。

![文件和代码模板设置](https://resources.jetbrains.com.cn/help/img/idea/2026.3/aqua_file_and_code_templates.png)

2. 选择   其他  选项卡。

3. 点击  `Selenium | 页面对象模板 | <所需语言>`

4. 从列表中选择所需的 Page Object 模板。

![页面对象模板列表](https://resources.jetbrains.com.cn/help/img/idea/2026.3/aqua_selenium_page_object_template.png)

5. 修改模板。

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

6. 点击   应用   以保存更改。

因此，所有新创建的 Page Objects 都将包含所提供的更改。

