依赖项与插件
配置构建
依赖项与插件 是 CoddyKit 上的免费 Kotlin Academy 课时。 这是第 2 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Kotlin Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Kotlin Academy 课程共包含 4 节课。
依赖项配置
Gradle 按配置对依赖项进行分组，配置会控制依赖项何时以及在哪里可用：
implementation— 编译时和运行时可用，但不会暴露给使用者api— 也会暴露给使用者testImplementation— 仅用于测试
implementation 与 api 对比
implementation 会对依赖您模块的模块隐藏依赖项，从而提高构建性能并增强封装性。只有当依赖项出现在您的公共类型中时，才使用 api。
dependencies {
api("com.squareup.okio:okio:3.9.0") // leaks into public API
implementation("com.google.code.gson:gson:2.11.0") // internal only
}compileOnly 与 runtimeOnly
有些依赖项只在一个阶段需要：
compileOnly— 在编译时存在，但不会被打包（例如注解）runtimeOnly— 仅在运行时存在（例如 JDBC 驱动程序）
dependencies {
compileOnly("org.projectlombok:lombok:1.18.32")
runtimeOnly("org.postgresql:postgresql:42.7.3")
}依赖项坐标
坐标的形式是 group:name:version。您也可以将其显式拆分，以提高可读性。
dependencies {
implementation(group = "org.jetbrains.kotlinx", name = "kotlinx-coroutines-core", version = "1.8.1")
}项目依赖项
在多模块构建中，一个模块通过 project(...) 依赖另一个模块。
dependencies {
implementation(project(":core"))
}应用核心插件
内置插件无需指定版本。社区插件需要通过 id 和版本来应用。
plugins {
id("java-library")
kotlin("jvm") version "2.0.0"
id("com.github.johnrengelman.shadow") version "8.1.1"
}来自插件门户的插件
通过 id 在 plugins { } 代码块中应用时，大多数插件会自动从 Gradle 插件门户解析。
plugins {
id("org.jetbrains.kotlin.plugin.serialization") version "2.0.0"
}排除传递性依赖项
您可以排除随其他库一同引入的不需要的传递性依赖项。
dependencies {
implementation("com.example:lib:1.0") {
exclude(group = "org.slf4j", module = "slf4j-api")
}
}强制指定版本
通过解析策略强制使用特定版本来解决冲突。
configurations.all {
resolutionStrategy {
force("com.google.guava:guava:33.2.1-jre")
}
}检查依赖关系树
使用 dependencies 任务查看已解析的依赖关系图并诊断冲突。
// ./gradlew dependencies
// ./gradlew app:dependencies --configuration runtimeClasspath选择正确的配置
默认使用 implementation。谨慎使用 api，使用 testImplementation 添加测试依赖，并使用 compileOnly/runtimeOnly 组合满足特定阶段的需求。
快速检查
某个日志记录库只在您的模块内部使用，并且从不出现在公共类型中。哪种配置最合适？
回顾
您完成了构建配置：
- 配置：
implementation、api、compileOnly、runtimeOnly、testImplementation - 通过 id（以及版本）应用插件，或应用核心插件
- 排除或强制指定版本，并检查依赖关系树
下一步：编写自定义任务。
常见问题解答
「依赖项与插件」课时是免费的吗？
是的 — 「依赖项与插件」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Kotlin Academy 课程的其余内容，请升级到 CoddyKit PRO。 Kotlin Academy 课程共包含 4 节课。
「依赖项与插件」这节课中我会学到什么？
配置构建 你通过在浏览器中直接运行的动手代码来练习 Kotlin Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 Kotlin Academy 需要有经验吗？
无需任何先前经验。CoddyKit 上的 Kotlin Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 2 节课，共 4 节。
「依赖项与插件」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 Kotlin Academy 课中编写并运行代码吗？
能。每节 Kotlin Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。