如何让IntelliJ IDEA遵循Gradle配置，避免生成重复out目录？

阿华AIGC实验室

2026-5-19

让IntelliJ IDEA完全遵循Gradle配置的步骤

当然可以让IDEA彻底跟着Gradle的规则走，再也不用纠结它自己生成的out目录和Gradle的build目录重复的问题了！我来一步步教你搞定：

1. 把Gradle设为默认构建工具

打开IDEA的设置（File → Settings，快捷键Ctrl+Alt+S更方便），导航到Build, Execution, Deployment → Build Tools → Gradle。

在这个页面里，找到两个关键选项：

Build and run using：选择Gradle
Run tests using：同样选择Gradle

这样设置后，IDEA就不会再用自己的编译系统瞎折腾了，全程调用Gradle处理构建、测试任务，从根源上避免输出目录冲突。

2. 强制IDEA使用Gradle的输出目录

还是在刚才的Gradle设置页面，往下找到Build output区域，勾选Use Gradle build output directory。

这一步会让IDEA彻底放弃自己的out目录，转而使用Gradle默认的输出路径：

主代码编译到build/classes/java/main
普通测试代码编译到build/classes/java/test
你自定义的integrationTest sourceSet会编译到build/classes/java/integrationTest（前提是Gradle配置里已经正确定义了这个sourceSet）

3. 确保自定义sourceSet的Gradle配置正确

如果你还没在Gradle里把integrationTest配置到位，可以参考下面的示例代码（放到build.gradle或build.gradle.kts里）：

Groovy版本

sourceSets {
    integrationTest {
        java.srcDir file('src/integrationTest/java')
        resources.srcDir file('src/integrationTest/resources')
        compileClasspath += main.output + test.output
        runtimeClasspath += main.output + test.output
    }
}

// 可选：给integrationTest添加专属测试任务
task integrationTest(type: Test) {
    testClassesDirs = sourceSets.integrationTest.output.classesDirs
    classpath = sourceSets.integrationTest.runtimeClasspath
}

Kotlin DSL版本

sourceSets {
    create("integrationTest") {
        java.srcDir("src/integrationTest/java")
        resources.srcDir("src/integrationTest/resources")
        compileClasspath += sourceSets.main.get().output + sourceSets.test.get().output
        runtimeClasspath += sourceSets.main.get().output + sourceSets.test.get().output
    }
}

// 可选：给integrationTest添加专属测试任务
tasks.register<Test>("integrationTest") {
    testClassesDirs = sourceSets["integrationTest"].output.classesDirs
    classpath = sourceSets["integrationTest"].runtimeClasspath
}

配置好后，点击IDEA右上角Gradle面板的刷新按钮（或者用File → Sync Project with Gradle Files），IDEA就会自动识别这个自定义sourceSet，严格按照Gradle的规则处理它的编译输出。