本文详细讲解如何在 gradle 构建的 jvm 项目中同时编译和运行 java 与 groovy 源码，涵盖标准目录结构配置、插件启用方式、跨语言调用示例及关键注意事项，无需额外编译器插件即可开箱即用。
本文详细讲解如何在 gradle 构建的 jvm 项目中同时编译和运行 java 与 groovy 源码，涵盖标准目录结构配置、插件启用方式、跨语言调用示例及关键注意事项，无需额外编译器插件即可开箱即用。
Gradle 原生支持 Java/Groovy 混合项目，无需引入 gmavenplus 等第三方编译插件（该插件主要面向 Maven）。其核心机制是通过 groovy 插件自动扩展 Java 编译任务，将 src/main/groovy 和 src/main/java（以及对应测试目录）统一纳入同一编译流程，并确保类型互引用正确解析。
✅ 正确配置步骤
-
应用 groovy 插件（而非 java 单独插件）：
plugins { id 'groovy' // 自动包含 java 插件功能 id 'application' // 如需可执行入口（如 main 方法） } -
保持标准源码目录结构：
Gradle 默认识别以下路径：- src/main/java/ → Java 源文件（.java）
- src/main/groovy/ → Groovy 源文件（.groovy）
- src/test/java/ 和 src/test/groovy/ → 对应测试代码
⚠️ 注意：无需手动创建 src/main/java 目录——Gradle 会自动识别；若项目初始化为纯 Groovy（如 gradle init --type groovy-application），该目录可能不存在，此时可安全手动创建，Gradle 将自动将其纳入编译源集（source set）。
确保包结构一致：
Java 与 Groovy 类可位于相同包路径下（如 mixedbuildtest），彼此可直接相互调用，无需任何特殊注解或桥接。
? 完整示例代码
目录结构：
立即学习“Java免费学习笔记（深入）”；
src/ ├── main/ │ ├── groovy/mixedbuildtest/App.groovy │ └── java/mixedbuildtest/JavaApp.java
src/main/groovy/mixedbuildtest/App.groovy：
package mixedbuildtest
class App {
String getGreeting() {
return 'Hello from Groovy!'
}
static void main(String[] args) {
println new App().greeting
println new JavaApp().greeting // 直接实例化 Java 类
}
}src/main/java/mixedbuildtest/JavaApp.java：
package mixedbuildtest;
public class JavaApp {
public String getGreeting() {
return "Hello from Java!";
}
}构建与运行：
./gradlew run
输出：
Hello from Groovy! Hello from Java!
⚠️ 关键注意事项
- 插件选择优先级：务必使用 id 'groovy'，而非仅 id 'java'。后者不支持 .groovy 编译；groovy 插件已内置 Java 支持，且能协调两种语言的联合编译顺序（Groovy 类可依赖 Java 类，反之亦然）。
- 依赖管理：Groovy 运行时（org.codehaus.groovy:groovy）由 groovy 插件自动添加至 implementation 配置，无需手动声明。
- IDE 兼容性：IntelliJ IDEA 和 VS Code（配合 Gradle 插件）能自动识别混合源集；Eclipse 用户建议使用 Buildship 并刷新项目配置。
-
避免常见误区：
❌ 不要尝试将 gmavenplus 作为 buildscript 依赖或 pluginManagement 插件——它不适用于 Gradle；
❌ 不要修改 sourceSets.main.java.srcDirs 手动合并路径——Gradle 已默认并行处理两个目录。
✅ 总结
Gradle 对 Java/Groovy 混合开发提供了开箱即用、零配置侵入的原生支持。只需启用 groovy 插件、遵循约定目录结构，即可实现双向类型引用、统一编译与测试。这种方式稳定、轻量，且完全兼容 Gradle 的增量编译与构建缓存机制，是企业级 JVM 多语言项目的推荐实践。
