# 运行、调试和测试 Groovy

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

> **TL;DR**
> 必需插件：   Groovy  （捆绑）

您可以像处理其他项目一样创建、导入、测试和运行 Groovy 应用程序。

> **Note:**
> 在开始使用 Groovy 之前，请确保在 IntelliJ IDEA 中 [已启用](managing-plugins.html) Groovy 插件。

Procedure: 创建一个 Groovy 项目

1. 在 [项目向导](new-project-wizard.html)中，选择   Groovy  。

2. 除了项目的名称和位置，您还可以选择以下选项：

* 创建 Git 仓库 ：如果您想为您的源代码创建一个新的 Git 仓库，请选择此选项。

* 构建系统 ：选择您希望在项目中使用的构建系统。 对小型测试类项目请选择 IntelliJ IDEA 。 如果您想用某个构建工具进行构建，请选择 [Maven](maven-support.html)或 [Gradle](gradle.html)。

* JDK ：指定您的项目 SDK。

* Groovy SDK ：指定 Groovy SDK。 IntelliJ IDEA 需要标准的 Groovy SDK 布局，这些布局可以通过官网发布的发行版获取 [http://groovy-lang.org/download.html](http://groovy-lang.org/download.html)。 下载 SDK，将其解压到任意目录，并将此目录指定为库主目录。

* 添加示例代码 ：选择此选项以创建一个包含简单示例代码的文件。

* 高级设置 ：使用此向导部分添加模块的名称、其内容根目录及其位置。

![Groovy 新项目](https://resources.jetbrains.com/help/img/idea/2026.3/groovy_new_project.png)

3. 点击   创建  。

要导入 Groovy 项目，请按照 [导入带有设置的项目](import-project-or-module-wizard.html#import-project) 部分中的步骤操作。

Procedure: 为现有项目添加 Groovy 支持

您可以为现有项目添加 Groovy 框架支持。 然而，如果您想为 [Gradle](gradle.html) 或 [Maven](maven-support.html) 项目添加 Groovy 支持，请使用它们的构建脚本文件 (  `build.gradle`  或  `pom.xml` )。 如需更多信息，请参阅 [Gradle](https://docs.gradle.org/current/userguide/groovy_plugin.html) 或 [Maven](https://groovy.github.io/gmaven/groovy-maven-plugin/) 文档。

1. 在   项目   工具窗口 `Alt+1` (Windows), `⌘ 1` (macOS), `⌘ 1` (IntelliJ IDEA Classic (macOS)), `⌘ 1` (macOS System Shortcuts), `Alt+1` (XWin), `Alt+1` (GNOME), `Alt+1` (KDE), `Alt+1` (Emacs), `Alt+1` (Sublime Text), `⌘ 1` (Sublime Text (macOS)), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Ctrl+1` (NetBeans), `Alt+1` (Eclipse), `Alt+1` (Eclipse (macOS)) 中，选择您想要添加 Groovy 支持的模块。

2. 按 `Ctrl+Shift+A` (Windows), `⌘ ⇧ A` (macOS), `⌘ ⇧ A` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ P` (macOS System Shortcuts), `Ctrl+Shift+A` (XWin), `Ctrl+Shift+A` (GNOME), `Ctrl+Shift+A` (KDE), `Escape, X` (Emacs), `Ctrl+Shift+P` (Sublime Text), `⌘ ⇧ P` (Sublime Text (macOS)), `Ctrl+Shift+A` (Visual Studio), `⌘ ⇧ A` (Visual Studio (macOS)), `Ctrl+I` (NetBeans), `Ctrl+Shift+A` (Eclipse), `⌘ 3` (Eclipse (macOS)) 并输入  `Add Framework Support` 。

一旦找到操作，点击它以打开   Add Framework Support  对话框。

3. 在打开的对话框中，选择   Groovy   并点击   OK  。

![“框架支持”对话框](https://resources.jetbrains.com/help/img/idea/2026.3/framework_support_dialog.png)

IntelliJ IDEA 将 Groovy SDK 添加到您的项目中，您可以添加 Groovy 类和 Groovy 脚本。

Procedure: 检查项目中 Groovy 的版本

您可以查看 IntelliJ IDEA 在项目中使用的 Groovy SDK 版本。

1. 在主菜单中，前往   文件 | 项目结构   `Ctrl+Alt+Shift+S` (Windows), `⌘ ;` (macOS), `⌘ ;` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ Comma` (macOS System Shortcuts), `Ctrl+Alt+Shift+S` (XWin), `Ctrl+Alt+Shift+S` (GNOME), `Ctrl+Alt+Shift+S` (KDE), `Ctrl+Alt+Shift+S` (Emacs), `Ctrl+Alt+Shift+S` (Sublime Text), `⌘ ;` (Sublime Text (macOS)), `Ctrl+Alt+Shift+S` (Visual Studio), `⌘ ;` (Visual Studio (macOS)), `Ctrl+Alt+Shift+S` (NetBeans), `Ctrl+Alt+Shift+S` (Eclipse), `⌘ ;` (Eclipse (macOS))。

2. 在   项目结构  对话框中，点击  `平台设置` ，选择   全球库  。

![项目结构对话框 / 全局库](https://resources.jetbrains.com/help/img/idea/2026.3/groovy_global_library.png) 如果您需要检查模块中使用的 Groovy SDK 版本，请选择   模块  ，模块的名称并点击   依赖项   选项卡。

![项目结构对话框 / 模块页面](https://resources.jetbrains.com/help/img/idea/2026.3/groovy_sdk_module.png)

Procedure: 更改项目中现有的 Groovy SDK 版本

1. 在   项目结构   `Ctrl+Alt+Shift+S` (Windows), `⌘ ;` (macOS), `⌘ ;` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ Comma` (macOS System Shortcuts), `Ctrl+Alt+Shift+S` (XWin), `Ctrl+Alt+Shift+S` (GNOME), `Ctrl+Alt+Shift+S` (KDE), `Ctrl+Alt+Shift+S` (Emacs), `Ctrl+Alt+Shift+S` (Sublime Text), `⌘ ;` (Sublime Text (macOS)), `Ctrl+Alt+Shift+S` (Visual Studio), `⌘ ;` (Visual Studio (macOS)), `Ctrl+Alt+Shift+S` (NetBeans), `Ctrl+Alt+Shift+S` (Eclipse), `⌘ ;` (Eclipse (macOS))对话框中，从   全球库  和模块依赖项（   模块  页面）中删除 `Ctrl+Y` (Windows), `⌘ ⌫` (macOS), `⌘ Y` (IntelliJ IDEA Classic (macOS)), `⌘ ⌫` (macOS System Shortcuts), `Ctrl+Y` (XWin), `Ctrl+Y` (GNOME), `Ctrl+Y` (KDE), `Ctrl+Y` (Emacs), `Ctrl+Shift+K` (Sublime Text), `⌃ ⇧ K` (Sublime Text (macOS)), `Ctrl+L` (Visual Studio), `⌘ ⇧ L` (Visual Studio (macOS)), `Ctrl+E` (NetBeans), `Ctrl+D` (Eclipse), `⌘ D` (Eclipse (macOS))现有的 Groovy SDK 版本。

2. 当移除 Groovy SDK 时，IntelliJ IDEA 会显示一个弹出窗口，建议添加 Groovy SDK。

![配置 Groovy SDK 弹出窗口](https://resources.jetbrains.com/help/img/idea/2026.3/groovy_sdk_configure_popup.png) 点击该链接并设置一个新的 SDK。

3. 如果 IntelliJ IDEA 未显示弹出窗口，请在   项目   工具窗口中右键点击项目名称，并在上下文菜单中选择   Add Framework Support  。

4. 在打开的对话框中，从技术列表中选择   Groovy  并添加一个新的 [Groovy library](#groovy_lib)。

![添加框架支持对话框](https://resources.jetbrains.com/help/img/idea/2026.3/groovy_add_library_dialog.png) IntelliJ IDEA 创建了一个全局级别的库。

Procedure: 运行 Groovy 应用程序

在您输入代码后，可以通过 IntelliJ IDEA 运行它，或者使用 [交互式 Groovy 控制台](launching-groovy-interaction-console.html)进行快速代码评估。

1. 在编辑器中打开您的应用程序。

2. 按 `Shift+F10` (Windows), `⌃ R` (macOS), `⇧ F10` (IntelliJ IDEA Classic (macOS)), `⌥ ⇧ R` (macOS System Shortcuts), `Shift+F10` (XWin), `Shift+F10` (GNOME), `Shift+F10` (KDE), `Shift+F10` (Emacs), `Shift+F10` (Sublime Text), `Shift+F10` (Sublime Text (macOS)), `Ctrl+F5` (Visual Studio), `⌃ F5` (Visual Studio (macOS)), `F6` (NetBeans), `Alt+Shift+X` (Eclipse), `⌘ ⇧ F11` (Eclipse (macOS)) 执行应用程序。 或者，您也可以在编辑器的左侧栏中，点击 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.toolwindows.toolWindowRun.svg)图标并选择   运行 'name'  。

![运行应用程序](https://resources.jetbrains.com/help/img/idea/2026.3/groovy_run_app_editor.png)

3. 在   运行   工具窗口中查看结果。

![运行工具窗口/运行 Groovy 应用程序](https://resources.jetbrains.com/help/img/idea/2026.3/groovy_run_tool_window.png)

> **Note:**
> 要运行 Groovy 脚本，请在编辑器的上下文菜单中选择   运行 'name'   `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))。

> **Tip:**
> 您还可以点击主工具栏上的 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.toolwindows.toolWindowRun.svg) 图标来运行您的应用程序。

Procedure: 调试 Groovy 应用程序

1. 在编辑器中打开您的 Groovy 应用程序。

2. 在左侧装订线上，设置您要调试的代码行的断点。 调试器了解 Groovy 语法，如果需要，您可以在断点上评估表达式。

![计算表达式](https://resources.jetbrains.com/help/img/idea/2026.3/groovy_evaluate_expression.png)有关断点的详细信息，请参阅 [断点](using-breakpoints.html)部分。

3. 如果您需要，您可以访问   运行/调试配置   对话框（Run | Edit Configurations）并调整设置，但通常默认设置足以成功开始和完成您的调试会话。

4. 按下 `Shift+F9` (Windows), `⌃ D` (macOS), `⇧ F9` (IntelliJ IDEA Classic (macOS)), `⌥ ⇧ D` (macOS System Shortcuts), `Shift+F9` (XWin), `Shift+F9` (GNOME), `Shift+F9` (KDE), `Shift+F9` (Emacs), `Shift+F9` (Sublime Text), `⌃ D` (Sublime Text (macOS)), `Alt+F5` (Visual Studio), `⌥ F5` (Visual Studio (macOS)), `Ctrl+F5` (NetBeans), `Alt+Shift+D` (Eclipse), `⌘ F11` (Eclipse (macOS))。 或者，您可以在主工具栏上点击 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.startDebugger.svg)图标来启动调试过程。

5. 在   调试   工具窗口中评估结果。

有关在   调试  工具窗口中使用选项的更多信息，请参阅 [调试代码](debugging-code.html)部分。

在调试模式下，您可以使用  评估表达式  工具 [评估任何表达式](examining-suspended-program.html#evaluating-expressions)，该工具可通过按 `Alt+F8` (Windows), `⌥ F8` (macOS), `⌥ F8` (IntelliJ IDEA Classic (macOS)), `⌘ ⌃ L` (macOS System Shortcuts), `Alt+F8` (XWin), `Alt+Shift+8` (GNOME), `Alt+Shift+8` (KDE), `Alt+F8` (Emacs), `Alt+F8` (Sublime Text), `⌥ F8` (Sublime Text (macOS)), `Shift+F9` (Visual Studio), `⇧ F9` (Visual Studio (macOS)), `Ctrl+F9` (NetBeans), `Ctrl+U` (Eclipse), `⌘ U` (Eclipse (macOS)) 访问。 该工具提供与编辑器相同的代码补全，因此可以轻松输入任意表达式。

有时，您可能希望单步调试进入特定的方法，而不是第一个将被调用的方法。 在这种情况下，通过按 `Shift+F7` (Windows), `⇧ F7` (macOS), `⇧ F7` (IntelliJ IDEA Classic (macOS)), `⌘ ⌥ ;` (macOS System Shortcuts), `Shift+F7` (XWin), `Shift+F7` (GNOME), `Shift+F7` (KDE), `Shift+F7` (Emacs), `Shift+F7` (Sublime Text), `⇧ F7` (Sublime Text (macOS)), `Shift+F7` (Visual Studio), `⇧ F7` (Visual Studio (macOS)), `Shift+F7` (NetBeans), `Ctrl+F5` (Eclipse), `⌥ F5` (Eclipse (macOS)) 使用  智能步入 来选择特定的方法。

> **Tip:**
> 如需了解更多调试信息，请参阅 [Debugging](debugging-code.html)部分。

Procedure: 测试 Groovy 应用程序

您可以使用 [JUnit 4](https://junit.org/junit4/)和 [JUnit 5](https://junit.org/junit5/)测试框架测试 Groovy 应用程序。

1. 在编辑器中打开一个类，您想为其创建一个测试，并将文本光标放置在包含类声明的行内。

2. 按 `Ctrl+Shift+T` (Windows), `⌘ ⇧ T` (macOS), `⌘ ⇧ T` (IntelliJ IDEA Classic (macOS)), `⌃ ⇧ T` (macOS System Shortcuts), `Ctrl+Shift+T` (XWin), `Ctrl+Shift+T` (GNOME), `Ctrl+Shift+T` (KDE), `Ctrl+Shift+T` (Emacs), `Ctrl+Shift+T` (Sublime Text), `Ctrl+Shift+T` (Sublime Text (macOS)), `Ctrl+Shift+T` (Visual Studio), `Ctrl+Shift+T` (Visual Studio (macOS)), `Ctrl+Shift+T` (NetBeans), `Ctrl+Shift+T` (Eclipse), `Ctrl+Shift+T` (Eclipse (macOS))并选择   创建新测试  。

3. 在打开的对话框中，指定测试设置并点击   OK  。

![创建 Groovy 测试](https://resources.jetbrains.com/help/img/idea/2026.3/create_groovy_test.png)

4. 在编辑器中打开测试，添加代码并按 `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)) 或右键点击测试类并从上下文菜单中选择   运行 '测试名称'  。

5. IntelliJ IDEA 会自动为该测试创建运行/调试配置，但如果想要编辑配置中的设置，请从主菜单中点击  `运行 | 编辑配置` 。

6. 在   运行/调试配置   对话框的右侧，指定测试套件的设置并点击   OK  。 该配置具有标准选项，更多详细信息可在 [运行测试](performing-tests.html) 部分中找到。

7. 在主工具栏上，点击 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.toolwindows.toolWindowRun.svg) 图标以运行测试。

8. 在   运行   工具窗口中评估结果。

> **Note:**
> 您可以在 Groovy 测试和测试对象之间导航(  `导航 | 测试／测试对象` )。 如果测试类尚不存在，IntelliJ IDEA 建议创建一个。

> **Tip:**
> 要部署您的 Groovy 应用程序，请参考 [与应用服务器协同工作](application-servers-support.html)。

> **Tip:**
> 要构建 Groovy 项目，IntelliJ IDEA 让您可以使用 [Gradle](gradle.html)、 [Maven](maven-support.html) 或 IntelliJ IDEA 自己的 [builder](https://www.jetbrains.com/zh-cn/help/idea/compiler-and-builder.html)。

## See also

### 过程

[Groovy 交互式控制台](launching-groovy-interaction-console.html)