IDEA项目需统一设为UTF-8编码：全局/项目/properties文件编码全设UTF-8，勾选透明转码；Maven中声明sourceEncoding；javac和java命令须显式指定-encoding UTF-8和-Dfile.encoding=UTF-8；文件读写必须显式指定Charset；Web端需配置Tomcat URIEncoding及Spring Boot编码强制策略。
IDEA 项目默认编码设为 UTF-8
IntelliJ IDEA 默认可能使用系统编码（如 Windows 的 GBK），导致 String 字面量、读写文件、控制台输出乱码。必须统一设为 UTF-8，且需同时配置三处：
-
File Encoding：Settings → Editor → File Encodings → Global Encoding / Project Encoding / Default encoding for properties files → 全部选
UTF-8 -
Properties 文件编码：勾选
Transparent native-to-ascii conversion，否则.properties中的中文会被自动转成\u4f60\u597d形式，且运行时无法正确还原 -
Maven 编译编码：在
pom.xml中显式声明，避免javac使用默认编码：UTF-8
Java 源文件编译与运行时的 -encoding 参数
javac 和 java 命令本身不继承 IDE 编码设置，命令行编译/运行时若源码含中文，必须显式指定编码，否则会报错或乱码：
-
javac -encoding UTF-8 Main.java：编译阶段告诉编译器“这个 .java 文件是 UTF-8 写的”，否则它按系统默认编码（如 Windows CMD 是 IBM437）解析源码，直接报非法字符 -
java -Dfile.encoding=UTF-8 Main：运行时设定 JVM 默认字符集，影响new String(byte[])、InputStreamReader无参构造等隐式使用默认编码的操作 - 注意：
-Dfile.encoding不影响Charset.defaultCharset()在某些 JDK 版本中的返回值（如 JDK 17+ 启动后不可变），但会影响大多数 I/O 类的默认行为
文件读写必须显式指定 Charset
依赖默认编码是最大隐患。以下操作看似简洁，实则危险：
-
Files.readString(path)和Files.writeString(path, str)（Java 11+）：底层调用StandardCharsets.UTF_8—— 这是特例，可安全使用 -
new FileReader(file)/new FileWriter(file)：使用平台默认编码，绝对不要用 - 正确写法：
Files.readAllLines(path, StandardCharsets.UTF_8); Files.write(path, lines, StandardCharsets.UTF_8);
- 流式读写：
new InputStreamReader(inputStream, StandardCharsets.UTF_8)、new OutputStreamWriter(outputStream, StandardCharsets.UTF_8)
Servlet 与 Spring Boot 的请求/响应编码
Web 场景下，浏览器和服务器之间传输的是字节，编码错配会导致参数乱码、响应中文显示为 ：
立即学习“Java免费学习笔记（深入）”；
- Tomcat 8.5+ 默认使用 UTF-8 解析 URL 和表单，但旧版本需在
server.xml的Connector中加：URIEncoding="UTF-8" - Spring Boot 2.3+ 默认启用
server.servlet.encoding.force=true，强制请求/响应使用 UTF-8；若关闭或自定义，需配置：server: servlet: encoding: charset: UTF-8 force: true - 手动处理请求体（如
HttpServletRequest.getInputStream()）时，仍需用new InputStreamReader(in, StandardCharsets.UTF_8)，不能依赖request.getCharacterEncoding()—— 它可能为null
真正麻烦的不是设一次 UTF-8，而是每个 IO 边界（源码、编译、启动、文件、网络）都得确认是否被某个默认值悄悄覆盖。尤其 FileReader 和未设 -Dfile.encoding 的脚本，最容易在上线后才暴露。
