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"></component>下添加<file url="PROJECT" charset="UTF-8"></file>
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></encoding>只影响src/main/java，资源文件（如src/main/resources）需额外配置maven-resources-plugin的encoding参数。
立即学习“Java免费学习笔记（深入）”；
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></encoder>指定<charset>UTF-8</charset>。
