如何在 IntelliJ IDEA 中配置和使用 Gradle

最新推荐文章于 2025-07-10 18:08:51 发布

原创最新推荐文章于 2025-07-10 18:08:51 发布 · 7.5k 阅读

17 ·

CC 4.0 BY-SA版权

文章标签：

#intellij-idea #java #ide

IntelliJ IDEA 完全支持 Gradle 构建工具，并提供了集成的 Gradle 项目管理功能。你可以使用 IntelliJ IDEA 来构建、运行和调试 Gradle 项目。

配置 Gradle 项目

如果你已有一个 Gradle 项目，以下是如何在 IntelliJ IDEA 中配置和使用 Gradle 的步骤：

1. 导入 Gradle 项目

打开 IntelliJ IDEA，点击 Open 或 Import Project，选择你的 Gradle 项目目录。
在弹出的对话框中，选择 Import project from external model，然后选择 Gradle 选项。
确保选择正确的 Gradle 配置：
- Gradle Wrapper：推荐使用 Gradle Wrapper，这样项目就会使用项目内定义的 Gradle 版本。
- Gradle Home：如果不使用 Wrapper，你可以选择本地安装的 Gradle。
点击 OK，IntelliJ IDEA 会自动识别并加载 Gradle 配置。

2. Gradle 配置文件

确保项目根目录下有 build.gradle 或 build.gradle.kts（如果你使用的是 Kotlin DSL）。这个文件是 Gradle 的构建脚本，IDEA 会根据这个文件来配置构建过程。

如果你的项目中没有这些文件，你可以手动创建一个 build.gradle 文件，或者选择从 IDE 中创建新的 Gradle 项目。

3. Gradle 项目同步

一旦项目导入或配置完成，IntelliJ IDEA 会自动同步 Gradle 配置文件并下载所有的依赖项。你可以看到一个 Gradle 视图，通常在 IDE 的右侧，显示所有的 Gradle 任务。

点击 Sync Project with Gradle Files 按钮（在 Gradle 工具窗口右上角的刷新图标）来强制重新同步 Gradle 文件。
如果 Gradle 配置发生变化，IDE 会自动提示你进行同步。

4. 配置 Gradle JVM

在 IntelliJ IDEA 中，你可以设置 Gradle 使用的 JVM（Java 版本）。如果你需要配置或更改它，可以按照以下步骤进行：

打开 File > Settings（Windows）或 IntelliJ IDEA > Preferences（macOS）。
导航到 Build, Execution, Deployment > Build Tools > Gradle。
在 Gradle JVM 部分选择适当的 JDK 版本。如果没有可用的 JDK，可以点击 Add JDK 来添加。

5. 运行 Gradle 任务

你可以通过 IDE 运行 Gradle 任务：

打开 Gradle 工具窗口（通常在右侧）。
在 Gradle 工具窗口中，找到你的 Gradle 项目，展开任务树。
右键点击某个任务（比如 build 或 test），然后选择 Run 或 Debug 来执行该任务。

6. 使用 Gradle Wrapper

推荐使用 Gradle Wrapper，这样可以确保项目使用指定版本的 Gradle，避免因不同开发者使用不同版本的 Gradle 而导致的问题。

在 Gradle 项目的根目录下，通常会有以下文件：

gradlew 和 gradlew.bat（Gradle Wrapper 脚本）
gradle/wrapper/gradle-wrapper.jar 和 gradle/wrapper/gradle-wrapper.properties（Gradle Wrapper 配置）

确保这些文件存在，Gradle 会自动使用 Wrapper 配置来运行 Gradle 任务。

7. Gradle 配置文件样例

一个简单的 build.gradle 文件（Groovy DSL）示例如下：

plugins {
    id 'java'
}

repositories {
    mavenCentral()
}

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-web:2.3.0.RELEASE'
    testImplementation 'org.junit.jupiter:junit-jupiter-api:5.7.0'
}

task customTask {
    doLast {
        println 'This is a custom Gradle task!'
    }
}

对于 Kotlin DSL（build.gradle.kts）的示例如下：

plugins {
    kotlin("jvm") version "1.5.30"
    application
}

repositories {
    mavenCentral()
}

dependencies {
    implementation(kotlin("stdlib"))
    testImplementation("org.junit.jupiter:junit-jupiter-api:5.7.0")
}

tasks.register("customTask") {
    doLast {
        println("This is a custom Gradle task!")
    }
}