Gradle 依赖配置详解：`api`、`compile`、`compileOnly`、`implementation` 的区别

原创

于 2025-02-26 16:55:21 发布 · 1.6k 阅读

在 Gradle 构建系统中，理解依赖配置对于优化项目结构和构建速度至关重要。随着 Gradle 版本的演进，compile 配置已经被废弃，取而代之的是更现代的 api 和 implementation 配置。此外，compileOnly 用于特定场景。这篇文章将详细介绍这些依赖配置的用法及其区别。

配置	编译时可见	运行时可见	传递到下游模块	适用场景
`compile`（已废弃）	✅	✅	✅	Gradle 旧版本的通用配置
`implementation`	✅	✅	❌	模块内部使用，不需要对外暴露的依赖
`api`	✅	✅	✅	构建公共库或共享依赖的多模块项目
`compileOnly`	✅	❌	❌	仅在编译时需要的依赖，如 Lombok 和注解处理器
`apiElements`	❌	❌	✅	用于控制库发布时的依赖暴露