java项目中可通过自定义sourceset配置非标准源码与资源路径，gradle自动识别编译打包并支持依赖传递；可重设main源集路径或新增独立源集（如api），并需同步ide元数据及显式配置资源处理与专属jar打包。
Java 项目中，若源码或资源不在 Gradle 默认的 src/main/java 和 src/main/resources 下（比如用 src/core/java、src/web/resources），只需通过自定义 SourceSet 显式声明路径即可，Gradle 会自动识别、编译、打包和参与依赖传递。
配置主源集（main）指向非标准目录
最常见需求是把整个 main 源集迁移到自定义位置。直接重设 java 和 resources 的目录：
- 在
build.gradle（Groovy）中：
sourceSets.main {
java.srcDirs = ['src/core/java', 'src/shared/java']
resources.srcDirs = ['src/core/resources', 'src/web/resources']
}
这样 gradle compileJava 就会扫描所有指定路径；生成的 jar 也会合并这些目录下的 class 和资源。
添加独立的自定义源集（如 integrationTest 或 api）
适合分层模块（如 API 层、集成测试、脚本工具等），不干扰 main 和 test：
- 声明新源集：
sourceSets {
api {
java.srcDir 'src/api/java'
resources.srcDir 'src/api/resources'
compileClasspath += sourceSets.main.output
runtimeClasspath += output + sourceSets.main.output
}
}
再为其配置编译任务和依赖：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
tasks.register('compileApiJava', JavaCompile) {
source = sourceSets.api.java
classpath = sourceSets.api.compileClasspath
destinationDirectory.set(file("$buildDir/classes/api"))
}
还可为它添加专属依赖（如 apiImplementation 'com.example:lib:1.0'），避免污染 main。
让 IDE（IntelliJ / Eclipse）正确识别路径
仅改 Gradle 不够，IDE 需同步元数据：
- IntelliJ：执行
Gradle → Refresh project，或打开File → Project Structure → Modules检查 Sources/Resource roots 是否已标记 - Eclipse：运行
./gradlew eclipse生成 .project/.classpath，再Import → Existing Projects into Workspace - 推荐加一句
idea { module { inheritClasspath = false } }避免继承冲突
注意资源过滤与打包行为
自定义资源目录默认不会被 processResources 处理 —— 必须显式加入：
processResources {
from sourceSets.main.resources.srcDirs
from sourceSets.api.resources.srcDirs
// 可附加 filter、expand 等逻辑
}
若要将 api 源集打到单独 jar，可定义：
tasks.register('apiJar', Jar) {
archiveClassifier = 'api'
from sourceSets.api.output
}
这样 ./gradlew apiJar 就输出 project-1.0-api.jar。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
