# 开始使用 Gradle > For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/idea/llms.txt). > **TL;DR** > 必需插件： Gradle 和 Gradle for Java （ [默认已安装并启用](managing-plugins.html#open-plugin-settings)） > > > > 教程 Gradle 版本：9.3.0 > > > > 教程 JDK 版本：25 > > > > 教程 JUnit 版本：6 本教程将演示如何在 IntelliJ IDEA 中创建和管理基于 Gradle 的项目。 将学习如何创建、运行和测试 Gradle 应用程序，并使用 Gradle 创建和运行可执行文件 JAR 文件。 可在 [GitHub](https://github.com/JetBrains/ij_tutorial_gradle) 上找到本教程使用的项目。 本教程使用 [Java 25](https://openjdk.org/projects/jdk/25/) 语法。 ## 步骤 1。 创建项目 让我们用 Gradle 构建系统创建一个新的 Java 项目，作为应用程序的基础。 Procedure: 创建新的 Gradle 项目。 1. 启动 IntelliJ IDEA。 在 IntelliJ IDEA 主屏幕上，点击 `新建 | 项目` 。 如果已经打开了项目，请从主菜单中选择 `文件 | 新建项目` 。 2. 在 新建项目 向导中，从 新建项目 列表中选择 Java 。 3. 请为项目命名（例如， `FizzBuzz` ），如有需要可更改默认位置。 4. 选择 Gradle 作为 构建系统 。 5. 从 JDK 列表中，选择最新可用的 Oracle OpenJDK 版本。 如果 JDK 已安装在计算机上但未在 IDE 中定义，请选择 添加 JDK 并指定 JDK 主目录的路径。 如果您的计算机上没有所需的 JDK，请选择 下载 JDK 。 6. 选择 Kotlin 作为 Gradle DSL ，保持 添加示例代码 选项为禁用状态。 7. 打开 高级设置 节点。 为 Gradle 版本 选择 自动选择 选项。 8. 在 ArtifactId 和 GroupId 字段中保留默认值。 点击 创建 。 ![新建 Gradle 项目](https://resources.jetbrains.com/help/img/idea/2026.3/gradle_project_wizard_start.png) 之后，IntelliJ IDEA 将创建并加载新的基于 Gradle 的项目。 让我们更详细地了解其组件： * IntelliJ IDEA 创建一个 `build.gradle.kts` 文件，内容如下： ```KOTLIN plugins { id("java") } group = "org.example" version = "1.0-SNAPSHOT" repositories { mavenCentral() } dependencies { testImplementation(platform("org.junit:junit-bom:6.0.0")) testImplementation("org.junit.jupiter:junit-jupiter") testRuntimeOnly("org.junit.platform:junit-platform-launcher") } tasks.test { useJUnitPlatform() } ``` IntelliJ IDEA 在创建项目时会自动添加测试依赖项。 * IntelliJ IDEA 还会创建 `src` 目录，并包含 `main` 和 `test` 子目录。 这些可以在 项目 工具窗口 ( `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))) 中查看。 ![Gradle 项目视图](https://resources.jetbrains.com/help/img/idea/2026.3/gradle_project_view.png) * 专用的 [Gradle 工具窗口](jetgradle-tool-window.html)（ `视图 | 工具窗口 | Gradle` ），可用以访问关联项目和其默认任务。 将使用此工具窗口运行教程任务。 ![Gradle 工具窗口](https://resources.jetbrains.com/help/img/idea/2026.3/gradle_tool_window.png) * 项目中的 [Gradle 设置](gradle-settings.html)用于存储有关已关联项目、Gradle JVM 和构建操作的信息。 您可以通过 Gradle 工具窗口，点击工具栏上的 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.settings.svg) 构建工具设置 ，快速访问这些设置。 ![Gradle 设置](https://resources.jetbrains.com/help/img/idea/2026.3/gradle_settings_FizzBuzz.png) 构建和测试操作由 Gradle 执行。 此外，Gradle 包装器 可确保项目使用特定 Gradle 版本。 * [项目结构](project-settings-and-structure.html)（ `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))）包含有关项目 SDK 及所用语言级别的信息。 ![项目结构](https://resources.jetbrains.com/help/img/idea/2026.3/project_structure_FizzBuzz.png) ## 步骤 2。 添加 Java 代码 现在让我们创建一个 Java 应用程序，该程序输出前 100 个 [FizzBuzz](https://en.wikipedia.org/wiki/Fizz_buzz) 数字。 Procedure: 将 Java 类添加到 Gradle 项目 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))）中，选择 `src/main/java` 目录。 2. 点击工具窗口工具栏上的 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.add.svg) 新建文件或目录 （或按 `Alt+Insert` (Windows), `⌘ N` (macOS), `⌃ N` (IntelliJ IDEA Classic (macOS)), `⌘ N` (macOS System Shortcuts), `Alt+Insert` (XWin), `Alt+Insert` (GNOME), `Alt+Insert` (KDE), `Alt+Insert` (Emacs), `Ctrl+N` (Sublime Text), `⌘ N` (Sublime Text (macOS)), `Ctrl+N` (Visual Studio), `⌘ N` (Visual Studio (macOS)), `Alt+Insert` (NetBeans), `Alt+Insert` (Eclipse), `⌘ N` (Eclipse (macOS))），然后选择 软件包 。 3. 在 新建包 对话框中，为软件包输入名称 `org.gradle.tutorial` 并按 `Enter` (Windows), `⏎` (macOS), `⏎` (IntelliJ IDEA Classic (macOS)), `⏎` (macOS System Shortcuts), `Enter` (XWin), `Enter` (GNOME), `Enter` (KDE), `Enter` (Emacs), `Enter` (Sublime Text), `⏎` (Sublime Text (macOS)), `Enter` (Visual Studio), `⏎` (Visual Studio (macOS)), `Enter` (NetBeans), `Enter` (Eclipse), `⏎` (Eclipse (macOS))。 4. 在 项目 工具窗口中，右键点击已创建的软件包并选择 `新建 | Java 类` 。 5. 为 Java 类指定名称（例如， `FizzBuzzProcessor` ），并按 `Enter` (Windows), `⏎` (macOS), `⏎` (IntelliJ IDEA Classic (macOS)), `⏎` (macOS System Shortcuts), `Enter` (XWin), `Enter` (GNOME), `Enter` (KDE), `Enter` (Emacs), `Enter` (Sublime Text), `⏎` (Sublime Text (macOS)), `Enter` (Visual Studio), `⏎` (Visual Studio (macOS)), `Enter` (NetBeans), `Enter` (Eclipse), `⏎` (Eclipse (macOS))。 6. 请将以下代码添加到 main `FizzBuzzProcessor.java` 类： ```JAVA package org.gradle.tutorial; public class FizzBuzzProcessor { private FizzBuzzProcessor() { } static void main(String[] args) { for (int i = 1; i <= 100; i++) { System.out.println(convert(i)); } } public static String convert(int fizzBuzz) { if (fizzBuzz % 15 == 0) { return "FizzBuzz"; } if (fizzBuzz % 3 == 0) { return "Fizz"; } if (fizzBuzz % 5 == 0) { return "Buzz"; } return String.valueOf(fizzBuzz); } } ``` 我们的应用程序已准备就绪。 现在，让我们为其创建必要的测试。 Procedure: 创建测试类 1. 在编辑器中打开 `FizzBuzzProcessor.java` 类，将文本光标放在类名称上，并转到 `导航 | 测试` （ `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))）。 点击 创建新测试 。 2. 在 创建测试 对话框中，选择 `JUnit6` 作为 测试库 ，并确保 `org.gradle.tutorial` 作为 目标软件包 已选中。 在 类名 字段中为测试类指定名称（例如 `FizzBuzzTest` ），并保留其余默认选项不变。 点击 OK 。 ![创建测试对话框](https://resources.jetbrains.com/help/img/idea/2026.3/create_test_FizzBuzz.png) 3. 在编辑器中打开已创建的测试类，并添加以下代码： ```JAVA package org.gradle.tutorial; import org.junit.jupiter.api.Assertions; import org.junit.jupiter.api.Test; public class FizzBuzzTest { @Test public void FizzBuzzNormalNumbers() { Assertions.assertEquals ("1", FizzBuzzProcessor.convert(1)); Assertions.assertEquals ("2", FizzBuzzProcessor.convert(2)); } @Test public void FizzBuzzThreeNumbers() { Assertions.assertEquals ("Fizz", FizzBuzzProcessor.convert(3)); } @Test public void FizzBuzzFiveNumbers() { Assertions.assertEquals ("Buzz", FizzBuzzProcessor.convert(5)); } @Test public void FizzBuzzThreeAndFiveNumbers() { Assertions.assertEquals ("FizzBuzz", FizzBuzzProcessor.convert(15)); } } ``` ## 步骤 3。 使用 Gradle 运行应用程序 让我们运行应用程序，查看是否可用。 Procedure: 从编辑器运行主类 1. 在编辑器中打开 `FizzBuzzProcessor.java` 类。 点击类定义旁的 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.gutter.run.svg) 装订区域图标并选择 运行 'FizzBuzzProcessor.main()' 来运行应用程序。 ![在 Gradle 中运行应用程序](https://resources.jetbrains.com/help/img/idea/2026.3/run_java_app_in_gradle_project.png) 2. 在 [运行工具窗口](run-tool-window.html) 中检查结果。 ![运行工具窗口](https://resources.jetbrains.com/help/img/idea/2026.3/run_java_app_with_gradle_result.png) ## 步骤 4。 运行测试 现在，让我们运行刚刚创建的测试。 Procedure: 在 Gradle 项目中运行测试 * 在编辑器中打开 `FizzBuzzTest.java` 测试类。 点击类定义旁的 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.actions.runAll.svg) 运行测试 装订区域图标，然后选择 运行 'FizzBuzzTest' 。 ![从代码区域执行 Gradle 测试](https://resources.jetbrains.com/help/img/idea/2026.3/gradle_run_test_editor.png) 测试结果将显示在 运行 工具窗口中。 ![运行工具窗口 /测试通过](https://resources.jetbrains.com/help/img/idea/2026.3/gradle_test_result_passed.png) 如果更改其中一个测试中的默认数字，测试将失败。 ![运行工具窗口 / 测试失败](https://resources.jetbrains.com/help/img/idea/2026.3/gradle_test_failed.png) 运行 工具窗口显示关于失败测试的信息，包括出错的具体代码行。 ## 步骤 5。 创建可执行 JAR 文件 让我们构建应用程序，以创建可执行文件 JAR 文件。 Procedure: 1. 在 项目 工具窗口中，找到 `build.gradle.kts` 文件并在编辑器中打开。 2. 请在文件尾部另起元素添加以下代码： ```KOTLIN tasks.jar { manifest { attributes["Main-Class"] = "org.gradle.tutorial.FizzBuzzProcessor" } from({ configurations.runtimeClasspath.get().map { if (it.isDirectory) it else zipTree(it) } }) } ``` 3. 点击编辑器中的 ![](https://resources.jetbrains.com/help/img/idea/2026.3/gradle.icons.gradleLoadChanges.svg) 同步 Gradle 更改 以同步更改到项目中。 4. 在 Gradle 工具窗口中，打开项目节点，然后转到 `任务 | 构建` 节点，双击 `构建` 任务以运行它。 ![Gradle 工具窗口：构建任务](https://resources.jetbrains.com/help/img/idea/2026.3/gradle_tool_window_build.png) IntelliJ IDEA 创建包含 JAR 文件的 `构建` 目录。 ![项目工具窗口：build 目录](https://resources.jetbrains.com/help/img/idea/2026.3/project_tool_window_build.png) 5. 请查看 运行 工具窗口中的结果。 ![运行工具窗口：构建任务](https://resources.jetbrains.com/help/img/idea/2026.3/run_tool_window_build_task.png) 请注意，构建任务包括 Gradle 执行的测试任务。 所以，如果我们在某个测试中出错，测试任务会失败，构建任务同样会失败。 ![运行工具窗口：构建失败测试](https://resources.jetbrains.com/help/img/idea/2026.3/run_tool_window_test_fail.png) ## 步骤 6。 使用 Gradle 运行 JAR 文件 让我们对 `build.gradle.kts` 文件做些调整，这样即可在 [运行任何内容](running-anything.html) 弹窗执行 JAR 文件。 Procedure: 运行 JAR 文件 1. 在 项目 工具窗口中，找到 `build.gradle.kts` 文件并在编辑器中打开。 2. 请按如下方式更改文件顶部的编码： ```KOTLIN plugins { id ("java") id ("application") } application { mainClass.set("org.gradle.tutorial.FizzBuzzProcessor") } ``` `build.gradle.kts` 文件的最终版本，包括所有更改，可在 [GitHub](https://github.com/JetBrains/ij_tutorial_gradle/blob/master/build.gradle.kts) 上获取。 3. 点击编辑器中的 ![](https://resources.jetbrains.com/help/img/idea/2026.3/gradle.icons.gradleLoadChanges.svg) 同步 Gradle 更改 以同步更改到项目中。 4. 在 Gradle 工具窗口中，打开项目的 任务 节点。 Gradle 在此新增了 分发 节点。 打开该节点并双击 `assembleDist` 任务以运行它。 IntelliJ IDEA 会在 `构建` 目录下创建更多子目录。 ![项目工具窗口：build 目录](https://resources.jetbrains.com/help/img/idea/2026.3/project_view_build_app.png) 5. 在 Gradle 工具窗口中，点击工具栏上的 ![运行任何内容](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.runAnything.svg) 执行 Gradle 任务 。 6. 在打开的 运行任何内容 弹窗中，找到 `gradlew :run` 命令并双击。 ![运行任何内容：gradlew run](https://resources.jetbrains.com/help/img/idea/2026.3/run_anything_gradle_run.png) 7. 在 运行 工具窗口中检查结果。 我们应当能获得与在 IntelliJ IDEA 编辑器中运行应用程序时相同的结果。 ![运行工具窗口：运行任务输出](https://resources.jetbrains.com/help/img/idea/2026.3/gradle_run_app_task_output.png) ## 总结 通过本教程，您已经学会了如何： * 在 IntelliJ IDEA 中 [创建与管理 Gradle 项目](#create_project) * 使用 Gradle [创建](#create_test)与 [运行测试](#run_test_gradle) * 使用 Gradle [创建](#deploy_gradle) 和 [运行可执行文件 JAR 文件](#run_terminal) ## 后续步骤 通过以下教程学习如何在 IntelliJ IDEA 中使用 Gradle 完成其他任务： * [将 Java 库发布到 Maven 仓库](add-a-gradle-library-to-the-maven-repository.html) * [在 Gradle 项目中设置 JNI 开发](setting-up-jni-development-in-gradle-project.html) 完整教程列表请参阅 [IntelliJ IDEA 教程](instance-tutorials.html)。 ## See also ### 过程 [Gradle](gradle.html) ### 参考 [设置](settings-preferences-dialog.html) [Gradle 设置](gradle-settings.html)