Go不原生支持Gradle，需用gogradle插件桥接；其golang{}块仅在正确声明插件后生效，且要求Gradle≥7.0、packagePath与模块路径严格一致。

Go 本身不原生支持 Gradle，Gradle 是 JVM 生态的构建工具。但如果你在项目中混合使用 Go 和 Java/Kotlin（比如 Android 项目调用 Go 编译的 AAR），或者想用 Gradle 统一管理含 Go 模块的多语言项目，就得靠插件桥接 —— 最常用、仍在维护的是 gogradle。

直接结论：不要试图用 Gradle 编译纯 Go 项目；要用 Gradle 管理 Go 构建，必须引入 gogradle 插件，且它只适用于特定场景（如 CI/CD 流水线统一调度、遗留 Gradle 工程中嵌入 Go 工具链）。

---

为什么 gradle build.gradle 里写 golang {} 不生效

gogradle 不是 Gradle 官方插件，也不会被默认识别。你看到的 golang { packagePath = '...' } 这类 DSL，只有在正确声明插件后才解析得动。

• 常见错误现象：Could not find method golang() for arguments 或 Plugin with id 'com.github.blindpirate.gogradle' not found
• 根本原因：插件未正确加载，或 Gradle 版本不兼容（gogradle 要求 Gradle ≥ 4.0，但最新版（v2.0+）已要求 Gradle 7.0+，且不再支持 JDK 8）
• 实操建议：
  • 确认 build.gradle 使用的是 plugins { ... } 块（不是旧式 apply plugin: '...'）
  • 从 GitHub 镜像页 查最新稳定版号（截至 2026 年 4 月，推荐 version '2.2.0'）
  • 确保 packagePath 与 Go 模块根目录的 import path 严格一致（例如 github.com/yourorg/yourgoapp），否则依赖解析会失败

---

gomobile bind 生成的 AAR 怎么被 Gradle 正确引用

这是最常见的“Go + Gradle”交集场景：用 gomobile bind -target=android 产出 .aar，再让 Android 项目的 build.gradle 加载它。

Golang Uber Dig

使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等

下载

• 常见错误现象：
  • Failed to resolve: mylib —— Gradle 找不到 AAR
  • 运行时报 UnsatisfiedLinkError: dlopen failed: library "libgojni.so" not found —— ABI 不匹配
• 实操建议：
  • 在 android { } 块内显式启用 prefab：prefabPublishing = true（Gradle Plugin ≥ 3.6 必须加，否则 native 接口无法暴露）
  • 声明依赖时不能只写 implementation(name: 'mylib', ext: 'aar')，必须加 transitive = true，否则 libgojni.so 等 transitive native 依赖不会被拉取
  • repositories { flatDir { dirs 'libs' } } 中的 libs 目录路径必须是相对于 build.gradle 所在模块的相对路径（例如模块是 app/，那 libs/ 就得放在 app/libs/）

---

gogradle 的 goTest 任务为啥不跑 go test -race

gogradle 默认的 goTest 任务不开启竞态检测，也不会自动读取 go.test.args 这类环境变量。

• 使用场景：你想在 CI 中强制跑带 -race 的测试，避免漏掉数据竞争
• 参数差异：
  • goTest 默认等价于 go test ./...
  • 要加 -race，得显式配置：goTest { args '-race' }
  • 若需过滤测试用例，可追加：args '-race', '-run', '^TestMyFunc$'
• 注意：开启 -race 后，二进制体积和内存占用明显上升，不适合在开发机频繁执行；建议仅在 CI job 中启用。

---

真正容易被忽略的一点：gogradle 不处理 go.mod 的 replace / exclude / indirect 语义。它依赖自己的依赖解析器（基于 dep 或 govendor 兼容层），对现代 Go Modules 的完整语义支持有限。如果你的项目重度使用 replace 指向本地路径或私有仓库，gogradle 很可能解析失败或静默跳过 —— 这时候不如直接用 go build + gradle exec 调用更可控。

golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！