17370845950

Java项目必须显式统一设置UTF-8编码：编译阶段用-javac -encoding UTF-8、Maven配encoding、Gradle设compileJava.options.encoding；运行阶段加-Dfile.encoding=UTF-8；IDE需同步全局、项目及properties文件编码；IO与网络操作须显式指定StandardCharsets.UTF_8，properties文件须无BOM。

Java项目默认使用系统编码，跨平台时极易出现中文乱码，必须显式统一设置为UTF-8。

编译阶段：javac命令必须加-encoding参数

即使源文件保存为UTF-8，javac默认按系统编码读取，Windows上常为GBK，导致编译时报错或生成错误字节码。

• 正确做法：所有javac调用都显式指定-encoding UTF-8，例如：

  javac -encoding UTF-8 src/com/example/Hello.java

• Maven项目需在pom.xml中配置maven-compiler-plugin的encoding属性为UTF-8
• Gradle项目需在build.gradle中设置compileJava.options.encoding = "UTF-8"

运行阶段：JVM启动参数要加-Dfile.encoding

System.getProperty("file.encoding")返回的值决定String.getBytes()、new String(byte[])等操作的默认编码，不设则继承操作系统，Linux和Window

• 必须添加JVM参数：-Dfile.encoding=UTF-8
• IDE中（如IntelliJ IDEA）需在Run Configuration → VM options里填写，不能只改文件编码设置
• Spring Boot应用若打成jar包运行，需在java -jar命令后加上该参数：

  java -Dfile.encoding=UTF-8 -jar myapp.jar

IDE与源文件：三处UTF-8必须同步

IDE设置、文件实际编码、项目配置不一致是乱码高发区，尤其在团队协作中。

• IntelliJ IDEA：进入File → Settings → Editor → File Encodings，把Global Encoding、Project Encoding、Default encoding for properties files全部设为UTF-8
• Eclipse：在Preferences → General → Workspace → Text file encoding选Other: UTF-8，并勾选Always use encoding specified in the file
• 检查已有Java文件是否真为UTF-8：用file -i filename.java（Linux/macOS）或Notepad++的编码菜单确认，避免BOM或ANSI残留

IO与网络：显式指定编码，绝不依赖默认

任何涉及字节与字符串转换的API，只要没传编码参数，就等于埋雷。

• 读写文件：用Files.readAllLines(path, StandardCharsets.UTF_8)，而非Files.readAllLines(path)
• 字符流：用InputStreamReader(in, StandardCharsets.UTF_8)，不用无参构造
• HTTP响应：Servlet中必须调用response.setCharacterEncoding("UTF-8")，且在getWriter()前设置
• JSON库（如Jackson）：配置ObjectMapper的setDefaultCharset(StandardCharsets.UTF_8)

最易被忽略的是Maven资源过滤和Spring Boot的application.properties加载——它们默认不识别UTF-8 BOM，含中文的properties文件必须保存为无BOM UTF-8，否则Spring会把开头的EF BB BF当乱码解析。