Gradle中Kotlin无法识别implementation()的问题求助

安全阿岳

2026-6-15

解决Gradle Kotlin DSL中“Unresolved reference: implementation”错误

问题根源

你的build.gradle.kts缺少必要的Gradle插件引入——implementation这类依赖配置函数是由Java/Kotlin相关插件提供的，Kotlin/Native项目必须先应用对应插件，Gradle才能识别这些语法。你当前的构建文件没有任何插件声明，Gradle不知道这是个Kotlin项目，自然会报错。

修复步骤

添加Kotlin插件
在构建文件最顶部加入插件配置，根据项目类型选择：

多平台项目用multiplatform插件：

plugins {
    kotlin("multiplatform") version "1.9.20" // 版本要和Gradle兼容，Gradle 8.10建议用1.9.x及以上
}

单平台Native项目用native插件：

plugins {
    kotlin("native") version "1.9.20"
}

调整依赖声明位置
多平台项目需要把依赖放在sourceSets对应的源码块里；单平台项目则放在kotlin块内。以下是完整的多平台示例：

plugins {
    kotlin("multiplatform") version "1.9.20"
}

repositories {
    mavenCentral()
    maven("https://maven.pkg.jetbrains.space/public/p/compose/dev")
}

val osName = System.getProperty("os.name")
val targetOs = when {
    osName == "Mac OS X" -> "macos"
    osName.startsWith("Win") -> "windows"
    osName.startsWith("Linux") -> "linux"
    else -> error("Unsupported OS: $osName")
}

val osArch = System.getProperty("os.arch")
val targetArch = when (osArch) {
    "x86_64", "amd64" -> "x64"
    "aarch64" -> "arm64"
    else -> error("Unsupported arch: $osArch")
}

val version = "0.8.9" // 可替换为更新版本
val target = "${targetOs}-${targetArch}"

kotlin {
    targetHierarchy.default()
    // 根据你的运行平台添加对应配置，比如macosArm64、windowsX64等
    linuxX64()
    sourceSets {
        val commonMain by getting {
            dependencies {
                implementation("org.jetbrains.skiko:skiko-awt-runtime-$target:$version")
            }
        }
    }
}