IDEA中使用Gradle构建项目中文报GBK错误的解决方案

在使用 IntelliJ IDEA 开发基于 Gradle 构建的项目时，开发者可能会遇到中文字符编码相关的 GBK 错误。这种错误通常发生在项目文件、资源文件或依赖项中包含非 ASCII 字符(如中文)的情况下，而系统的默认编码与项目期望的编码不一致。这类问题不仅会影响项目的正常编译和运行，还可能导致构建失败或生成的文件内容损坏。

本文提供了三种解决方法，帮助开发者快速定位并解决 IDEA 中使用 Gradle 构建项目时出现的 GBK 编码错误。

编码时无报错, 构建运行时Gradle报错

解决方法一(推荐)

修改build.gradle配置文件

• Groovy语言配置文件 build.gradle

tasks.withType(JavaCompile) {  
    options.encoding = "UTF-8"  
}

• Kotlin语言配置文件 build.gradle.kts

tasks.test {
    //  设置编码为utf8
    systemProperty("file.encoding", "UTF-8")
}

解决方法二

我们可以不使用Gradle来构建和运行应用, 我们可以使用IDEA进行构建运行

解决方法三(不推荐)

直接修改文件格式成GBK, 临时方法

总结

GBK 编码错误的核心原因在于系统默认编码与项目所需编码之间的不匹配。为了解决这一问题，可以从以下几个方面入手：调整操作系统的区域设置、配置 IDEA 的全局编码参数、修改 Gradle 构建脚本中的编码选项以及确保项目文件本身的编码一致性。通过这些措施，可以有效避免因编码问题导致的构建失败，从而提升开发效率和项目稳定性。