本文最后更新于 1 年前 ，文中信息可能已经过时。如有问题请在评论区留言。

Gradle 目前支持两种 DSL（Domain Specific Language）：Groovy DSL 和 Kotlin DSL

更改 Gradle 本地仓库

新建环境变量 GRADLE_USER_HOME，并指定路径，即可修改 Gradle 本地仓库地址。

image-wprs.png

指定 Java 版本

Kotlin DSL

kotlin
1

java.sourceCompatibility = JavaVersion.VERSION_17

Javadoc 编码问题

问题详情：

text
1

error: unmappable character (0x89) for encoding GBK

解决方式：

Kotlin DSL

在 build.gradle.kts 文件中添加如下内容：

kotlin
1
2
3
4
5
6
7
8

tasks {
    compileJava {
        options.encoding = "UTF-8"
    }
    compileTestJava {
        options.encoding = "UTF-8"
    }
}

无法识别 lombok 问题

Kotlin DSL

kotlin
1
2
3
4

// lombok 使用如下依赖 (版本号可替换)
// https://mvnrepository.com/artifact/org.projectlombok/lombok
compileOnly("org.projectlombok:lombok:1.18.26")
annotationProcessor("org.projectlombok:lombok:1.18.26")

distributionUrl 国内镜像

gradle/wrapper/gradle-wrapper.properties 文件 distributionUrl 默认如下（以 Gradle 8.7 为例）：

properties
1

distributionUrl=https\://services.gradle.org/distributions/gradle-8.7-bin.zip

因为众所周知的原因，在国内使用该地址下载可能受阻。我们可以改用国内镜像地址（以腾讯镜像为例）：

properties
1

distributionUrl=https\://mirrors.cloud.tencent.com/gradle/gradle-8.7-bin.zip

或者也可以指向本地文件：

properties
1

distributionUrl=file:///D:/Downloads/gradle-8.7-bin.zip

建议使用国内镜像。