Java项目默认编码设置为UTF-8方法解析

Java项目需统一UTF-8编码：IDEA中三处设置、Maven编译encoding、JVM参数-Dfile.encoding、Spring Boot的server.servlet.encoding及Logback charset均须显式配置，否则String、文件I/O、控制台、HTTP、日志等均可能乱码。

Java项目默认编码不是UTF-8，除非显式配置；JVM启动参数、IDE设置、构建工具配置三者不一致时，String读写、文件I/O、控制台输出都可能乱码。

IDEA中必须改的三个地方

IntelliJ IDEA不会自动同步项目编码设置，光改File Encoding面板不够：

• 菜单 File → Settings → Editor → File Encodings：把 Global Encoding、Project Encoding、Default encoding for properties files 全部设为 UTF-8
• 右下角状态栏点击当前编码（如GBK），选 Convert to UTF-8 并勾选 Transparent native-to-ascii conversion（否则中文注释会变成\u4f60\u597d）
• 检查 .idea/workspace.xml 中是否含 encoding="UTF-8"，若没有，手动在 <component name="EncodingManager"> 下添加 <file url="PROJECT" charset="UTF-8" />

Maven编译时指定源码编码

javac 默认用系统编码编译，Windows上常是GBK，导致String字面量编译出错：

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-compiler-plugin</artifactId>
  <version>3.11.0</version>
  <configuration>
    <source>17</source>
    <target>17</target>
    <encoding>UTF-8</encoding>
  </configuration>
</plugin>

注意：<encoding>只影响src/main/java，资源文件（如src/main/resources）需额外配置maven-resources-plugin的encoding参数。

JVM启动参数强制统一字符集

即使代码和编译都用了UTF-8，运行时仍可能因系统默认编码出问题，尤其涉及new Scanner(System.in)或Files.readAllLines()：

• IDEA运行配置里，在 VM options 加：-Dfile.encoding=UTF-8
• Maven命令行运行时加：mvn spring-boot:run -Dspring-boot.run.jvmArguments="-Dfile.encoding=UTF-8"
• Linux部署脚本中，启动JAR前设置：export JAVA_TOOL_OPTIONS="-Dfile.encoding=UTF-8"（比-D更优先，且对所有JVM子进程生效）

⚠️ 不要用-Dsun.jnu.encoding——它只影响文件名编码，现代Java已废弃，且与file.encoding冲突时会导致不可预测行为。

Spring Boot项目的特殊处理点

Spring Boot内嵌Tomcat和WebMvcConfigurer会分别影响HTTP请求/响应编码，仅设JVM参数不够：

• 在application.properties中必须显式配置：server.servlet.encoding.charset=UTF-8 和 server.servlet.encoding.force=true
• 若用@RequestBody接收JSON中文，还需确认HttpMessageConverter使用StringHttpMessageConverter并设其defaultCharset为UTF_8（Spring Boot 2.3+默认已做）
• 静态资源（HTML/CSS/JS）的<meta charset="UTF-8">必须存在，否则浏览器可能按系统编码解析，与服务端返回的Content-Type: text/html;charset=UTF-8不一致

最易忽略的是日志框架——Logback默认用系统编码写日志文件，需在logback-spring.xml中为<encoder>指定<charset>UTF-8</charset>。