使用Kotlin 1.2.40仍报use方法编译错误，Gradle构建异常求助

我之前也碰到过一模一样的情况——IDE里编译好好的，一用gradlew build或gradlew install就报Kotlin版本不兼容的错，其实核心原因就是命令行的Gradle环境和IDE用的配置没对齐，下面给你几个排查和解决的方向：

1. 检查Gradle构建脚本里的Kotlin插件版本是否明确配置 #

很多人只在IDE的设置里指定了Kotlin版本，但忘了在build.gradle（或build.gradle.kts）里明确声明，IDE会自动用自己的配置，但命令行的Gradle只会严格按照脚本里的配置来执行。

Groovy脚本（build.gradle）示例： #

buildscript {
    // 明确指定Kotlin版本为1.2.40
    ext.kotlin_version = '1.2.40'
    repositories {
        mavenCentral()
    }
    dependencies {
        // 引入对应版本的Kotlin Gradle插件
        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
    }
}

apply plugin: 'kotlin'

repositories {
    mavenCentral()
}

dependencies {
    // 依赖对应版本的Kotlin标准库
    implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk8:$kotlin_version"
}

Kotlin DSL脚本（build.gradle.kts）示例： #

plugins {
    // 直接指定Kotlin插件版本
    kotlin("jvm") version "1.2.40"
}

repositories {
    mavenCentral()
}

dependencies {
    implementation(kotlin("stdlib-jdk8"))
}

如果项目是多模块结构，记得所有子模块的构建脚本也要同步这个版本配置，或者通过根项目的build.gradle统一管理版本。

2. 确认命令行使用的Gradle环境版本 #

IDE默认会用项目根目录的Gradle Wrapper（也就是gradlew脚本），但如果你不小心用了全局安装的Gradle（比如直接敲gradle而不是./gradlew），可能会因为Gradle版本太低不支持Kotlin 1.2.40。

你可以先运行这个命令查看当前Gradle环境的详细信息：

# macOS/Linux
./gradlew --version

# Windows
gradlew.bat --version

输出里要重点看Kotlin:那一行，确认版本是1.2.40左右。如果不是，可能是Gradle Wrapper的版本太低——Kotlin 1.2.40需要至少Gradle 4.0以上的版本支持，你可以修改gradle/wrapper/gradle-wrapper.properties里的distributionUrl，换成符合要求的Gradle版本，比如：

distributionUrl=https\://services.gradle.org/distributions/gradle-4.10.2-all.zip

3. 清理Gradle缓存 #

有时候Gradle会缓存旧的编译文件，导致即使你改了配置，命令行编译还是用旧版本的依赖。你可以先执行清理命令再重新构建：

# macOS/Linux
./gradlew clean build

# Windows
gradlew.bat clean build

如果还是不行，可以手动删除项目根目录的.gradle文件夹和所有模块下的build文件夹，然后再重新运行构建命令。

4. 检查IDE的Gradle配置是否和命令行一致 #

虽然IDE编译正常，但还是可以确认一下：打开IntelliJ的File > Settings > Build, Execution, Deployment > Build Tools > Gradle，确保Use Gradle from选项选的是'gradle-wrapper.properties' file，这样IDE和命令行用的就是同一个Gradle环境，避免出现配置差异。

按照上面的步骤排查下来，基本就能解决这个问题了。

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