build.gradle.kts中import语句报错：Unresolved reference问题排查

错误原因分析 #

出现“Unresolved reference: import”和“Expecting an element”错误，大概率是以下两种情况之一：

• import语句位置错误：在.kts格式的Gradle配置文件中，import必须放在文件的顶层最开头，不能嵌套在{}代码块或其他非顶层位置，否则会被Gradle解析为无效语法。
• 内部API访问限制：org.gradle.internal.os.OperatingSystem属于Gradle内部私有API，Gradle 8.x版本进一步收紧了内部API的访问权限，直接import会触发编译错误。

具体解决方案 #

方案1：修正import语句位置 #

确保import放在文件最顶部，示例如下：

// 正确位置：文件最开头
import org.gradle.internal.os.OperatingSystem

plugins {
    id("java")
}

// 后续配置代码
tasks.withType<Test> {
    if (OperatingSystem.current().isWindows) {
        // Windows专属配置
    }
}

方案2：替换为公开API（推荐） #

由于内部API可能在后续Gradle版本中被移除，建议使用公开方式判断操作系统：

方式A：使用Java系统属性

val isWindows = System.getProperty("os.name").lowercase().contains("win")

tasks.withType<Test> {
    if (isWindows) {
        // Windows专属配置
    }
}

方式B：使用Gradle公开的平台检测API

import org.gradle.nativeplatform.platform.OperatingSystemFamily

tasks.withType<Test> {
    if (operatingSystemFamily.get() == OperatingSystemFamily.WINDOWS) {
        // Windows专属配置
    }
}

方案3：放宽内部API访问限制（不推荐） #

如果必须使用该内部类，可以在settings.gradle.kts中添加配置放宽访问限制，但此方法可能导致后续版本兼容性问题：

gradle.settingsEvaluated {
    repositories {
        // 确保仓库配置
    }
}

gradle.projectsEvaluated {
    tasks.withType<JavaCompile> {
        options.compilerArgs.add("--add-opens=org.gradle.internal.os/org.gradle.internal.os=ALL-UNNAMED")
    }
}

内容的提问来源于stack exchange，提问作者RatRatARMY