Gradle Java编译出现中文乱码怎么办-java教程-PHP中文网

根本原因是源文件为UTF-8编码而javac默认用GBK读取；必须在build.gradle中配置tasks.withType(JavaCompile) { options.encoding = "UTF-8" }，该设置显式指定编译器读源码编码，覆盖系统locale fallback，且需配合IDE三处编码设为UTF-8并重启生效。

gradle java编译出现中文乱码怎么办

Gradle Java 编译时出现中文乱码（比如 javac 报“非法字符”或注释/字符串显示为 ???），根本原因只有一个：源文件是 UTF-8 编码，但 javac 默认用系统编码（Windows 下常为 GBK）去读取它。不是 IDEA 显示问题，也不是控制台输出问题——编译阶段就失败了。

build.gradle 中必须配置 `JavaCompile.encoding`

这是最直接、最有效的修复点。Gradle 不会自动继承 IDEA 的文件编码设置，javac 启动时若未显式指定 -encoding，就会 fallback 到系统 locale 编码。

tasks.withType(JavaCompile) { options.encoding = "UTF-8" } 是最低要求，必须加
如果用 Kotlin DSL（build.gradle.kts），写成 tasks.withType { options.encoding = "UTF-8" }
不要只配 compileJava 任务——它只是别名，withType(JavaCompile) 才能覆盖所有 Java 编译任务（包括测试编译）
这个配置只影响编译器读源码的编码，和运行时无关；即使你后续加了 -Dfile.encoding，没这行照样报错

IDEA 的 File Encoding 设置只是表象

右下角显示 UTF-8 只代表 IDEA 当前以 UTF-8 解析文件，并不改变 Gradle 构建行为。很多人改完这里仍乱码，就是因为没动 build.gradle。

确保 File → Settings → Editor → File Encodings 中三处都设为 UTF-8：Global Encoding、Project Encoding、Default encoding for properties files
但注意：改完后需重启 IDEA，且已有文件可能需要手动 Reload project from disk 或重新打开，否则缓存仍按旧编码解析
如果项目是从 SVN/Git 拉下来的，检查 .gitattributes 是否强制设置了 * text=auto eol=lf，避免换行符干扰编码识别

不要依赖 `-Dfile.encoding` 解决编译乱码

网上大量教程让加 -Dfile.encoding=UTF-8 到 VM Options，这对 JavaExec 或 Test 任务有用，但对 JavaCompile 完全无效——javac 不读这个 JVM 参数。

Java Api Extractor

从 Java 项目中提取 Controller 层接口定义为 JSON 数据。

下载

javac 唯一认的编码参数是 -encoding，对应 Gradle 的 options.encoding
-Dfile.encoding 影响的是 Charset.defaultCharset()，即 new String(bytes) 或 Files.readAllLines() 等 API 的默认行为，不是编译器
如果你在 build.gradle 里同时写了 options.encoding 和 jvmArgs += "-Dfile.encoding=UTF-8"，后者对编译无意义，纯属冗余

Windows 下还需留意控制台活动代码页

即使编译通过，运行时控制台仍可能乱码，尤其当你用 gradle run 或 JavaExec 启动主类时。这是因为 Windows 控制台默认用活动代码页（chcp 查看）解释输出字节流。

临时解决：在 CMD 中先执行 chcp 65001，再跑 gradle run
长期解决：在 build.gradle 中给 JavaExec 加系统属性：systemProperty "file.encoding", "UTF-8"，并确保终端本身支持 UTF-8（Win10+ 建议启用「Beta: 使用 Unicode UTF-8 提供全球语言支持」）
注意：PowerShell 默认不尊重 chcp，它的显示编码由 $OutputEncoding 控制，需额外设为 [Console]::OutputEncoding = [System.Text.Encoding]::UTF8