IntelliJ识别自定义SourceSet报错：添加依赖提示无响应求解决方案

问题背景 #

在库项目中自定义了名为eg的SourceSet，用于构建一个调用本库但不包含在库内的可执行Jar。通过Gradle命令./gradlew foobar可正常构建并运行，但IntelliJ编辑器中Foobar.kt里的Example类出现「未解析引用」错误，点击「Add dependency on module Problem.main」提示无响应。

临时解决办法 #

• 手动添加模块依赖：打开IntelliJ的Project Structure（快捷键Ctrl+Alt+Shift+S），找到eg对应的模块，切换到「Dependencies」标签页，点击「+」选择「Module Dependency」，手动添加对主模块（main）的依赖。
• 强制刷新Gradle配置：点击Gradle面板的「刷新所有Gradle项目」按钮，或者在终端执行./gradlew cleanIdea idea重新生成IntelliJ配置文件，之后重新导入项目。
• 显式配置源码集依赖：在build.gradle.kts中给eg SourceSet添加对主源码集的编译/运行时依赖，强制IntelliJ识别关联关系：

sourceSets {
    val eg by creating {
        java.srcDir("src/eg/kotlin")
        resources.srcDir("src/eg/resources")
        // 显式关联主源码集的输出
        compileClasspath += sourceSets.main.get().output
        runtimeClasspath += sourceSets.main.get().output
    }
}

更规范的实现方式 #

方式1：结合Application插件管理可执行工具 #

使用Gradle的application插件来统一管理可执行模块，让IntelliJ更好地识别源码集间的依赖：

plugins {
    `java-library`
    kotlin("jvm") version "1.9.0"
    application
}

sourceSets {
    val eg by creating {
        java.srcDir("src/eg/kotlin")
        resources.srcDir("src/eg/resources")
        dependencies {
            // 依赖主源码集的输出与编译路径
            implementation(sourceSets.main.get().output)
            implementation(sourceSets.main.get().compileClasspath)
        }
    }
}

application {
    mainClass.set("com.example.Foobar")
    // 指定使用eg源码集作为应用入口
    sourceSets = listOf(sourceSets["eg"])
}

// 保留自定义foobar任务，依赖application的run任务
tasks.register("foobar") {
    dependsOn(tasks.run)
}

方式2：拆分为独立子模块 #

将工具代码拆分为单独的子模块（比如tool-eg），主库模块作为java-library，工具子模块依赖主库模块。这种结构更清晰，IntelliJ能自动识别跨模块依赖，避免自定义源码集的识别问题：

// 主库模块build.gradle.kts
plugins {
    `java-library`
    kotlin("jvm") version "1.9.0"
}

// 工具子模块build.gradle.kts
plugins {
    application
    kotlin("jvm") version "1.9.0"
}

dependencies {
    implementation(project(":main-library"))
}

application {
    mainClass.set("com.example.Foobar")
}

内容的提问来源于stack exchange，提问作者wholerabbit