# Cypress

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

> **Note:**
> 在 IntelliJ IDEA 中对 Cypress 的支持是由 [Test Automation](https://plugins.jetbrains.com/plugin/20175-test-automation)插件提供的，本节中描述的大多数功能都依赖于它。 然而，运行 Cypress 测试等基本功能无需插件即可正常运行。

![](https://resources.jetbrains.com.cn/help/img/idea/2026.3/aqua-plugin.icons.cypress.svg) [Cypress](https://www.cypress.io/) 是一个开源的 Web 应用程序测试框架。 它为开发者提供快速且可靠的端到端测试自动化解决方案。 凭借独特的架构和全面的功能集，Cypress 实现了高效的测试编写、调试，以及与最受欢迎的框架和 CI/CD 管道的集成。

## 创建一个新的 Cypress 项目

Procedure:

1. 在主菜单中，前往  `文件 | 新建 | 项目` 。

或者，如果在   欢迎   屏幕上，请点击   新建项目  。

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

![创建新 Cypress 项目](https://resources.jetbrains.com.cn/help/img/idea/2026.3/ij_cypress_new_project.png)

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

4. 请指定   Node.js 运行时  。

5. 请指定   包管理器  。

6. 从   语言   列表中选择您想要使用的语言。

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

8. （可选）启用   配置 E2E 测试   参数以创建一组支持文件，用于引入自定义命令或全局覆盖以应用于您的 spec 文件。

9. （可选）启用   配置组件测试   参数来设置和配置组件测试框架。 一旦   配置组件测试  参数启用，从列表中选择所需的框架。

![创建一个带有组件测试的 Cypress 项目](https://resources.jetbrains.com.cn/help/img/idea/2026.3/aqua_cypress_project_w_component_tests.png)

> **Note:**
> 所有额外依赖项将自动添加到项目中。

10. 点击   创建  。

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

## 添加元素到代码

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/ps_run_tests_cypress.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_cypress_review_tests.png)

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

## 调试测试

> **Note:**
> 由于框架特性的限制，经典的  "IDE 内" 调试方法并不真正适用于 Cypress。 但是，如果您有适合经典方法的用例，请随时使用 [此](https://youtrack.jetbrains.com/newIssue?project=AQUA&summary=%5BIn-IDE+Cypress+Debugging%5D+%3CSpecify+a+title+here%3E&description=**Description%3A**%0A%3CProvide+a+description+of+your+use+case+and+share+your+thoughts+on+why+you+think+a+classic+%22in-IDE%22+debugging+approach+makes+sense+in+your+particular+case.%3E%0A%0A**Additional+information**%0A%3CFeel+free+to+include+any+relevant+details+such+as+the+context%2C+steps+to+reproduce%2C+screenshots%2C+etc.%3E%0A%0A**IDE**%0A%3CWhat+IDE+do+you+use%3F%3E&c=add+Board+Aqua%3A+PM+%26+Strategy&c=add+Board+Aqua%3A+Content+%26+Marketing&c=Type+Usability+Problem&c=Subsystem+Frameworks&c=Framework+Cypress)表单与我们分享。

## 修改运行/调试配置

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

Procedure:

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

![选择运行/调试配置](https://resources.jetbrains.com.cn/help/img/idea/2026.3/aqua_cypress_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_cypress_template.png)

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

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

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

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

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

5. 点击   OK   以保存更改。

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

## 打开 Cypress Launchpad

如果需要，您可以在 [Cypress Launchpad](https://docs.cypress.io/guides/getting-started/opening-the-app#The-Launchpad) 中打开您当前的项目。 要做到这一点，请按 `⌘ ⌃ ]` (Windows), `⌘ ⌃ ]` (macOS), `⌘ ⌃ ]` (IntelliJ IDEA Classic (macOS)), `⌘ ⌃ ]` (macOS System Shortcuts), `⌘ ⌃ ]` (XWin), `⌘ ⌃ ]` (GNOME), `⌘ ⌃ ]` (KDE), `⌘ ⌃ ]` (Emacs), `⌘ ⌃ ]` (Sublime Text), `⌘ ⌃ ]` (Sublime Text (macOS)), `⌘ ⌃ ]` (Visual Studio), `⌘ ⌃ ]` (Visual Studio (macOS)), `⌘ ⌃ ]` (NetBeans), `⌘ ⌃ ]` (Eclipse), `⌘ ⌃ ]` (Eclipse (macOS))。

![Cypress Launchpad](https://resources.jetbrains.com.cn/help/img/idea/2026.3/cypress_launchpad.png)

## See also

### 外部链接

[Cypress](https://www.cypress.io/)

