Java设置UTF-8编码防乱码技巧

Java开发中中文乱码问题根源在于编码不统一——从IDE设置、源码编译、控制台输出，到文件读写、HTTP请求响应，多个环节若未显式统一使用UTF-8，就会在不同平台或环境下悄然出现“???、方块、\u4f60\u597d”等典型乱码现象；本文系统梳理了IntelliJ IDEA配置、javac命令行参数、JVM文件操作API、Spring Boot Web层等关键场景的强制UTF-8实践方案，强调“显式指定、处处设防”，帮你彻底告别因编码隐式依赖系统默认值而导致的跨环境翻车。

IDEA 里 file.encoding 和 console.encoding 必须一致

Java 源文件读取、编译、运行时控制台输出，三者编码不统一是乱码最常见原因。IntelliJ IDEA 默认可能用系统编码（比如 Windows 的 GBK），但项目源码是 UTF-8，结果编译时字面量被错误解码，运行时又用 GBK 解 console 输出——中文直接变 ??? 或方块。

• 进 File → Settings → Editor → File Encodings，把 Global Encoding、Project Encoding、Default encoding for properties files 全设成 UTF-8
• 关键一步：点右下角齿轮图标 → Configure → Configure IDE Encoding，勾选 Override default encoding for console，并设为 UTF-8
• 如果用了 Maven，还要在 pom.xml 中显式指定编译编码：

  <properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
  </properties>

javac 命令行编译必须加 -encoding UTF-8

不用 IDE 直接敲 javac？默认会按系统 locale 解码源码。Windows 上跑 javac Main.java，哪怕文件存的是 UTF-8，也会被当成 GBK 解析，中文字符串字面量直接报错 illegal character: '\uFFFD' 或编译后输出乱码。

• 永远显式带上参数：javac -encoding UTF-8 Main.java
• 如果写成脚本或 Makefile，别漏掉这个参数；CI 环境（如 GitHub Actions）更要注意，默认 runner 是英文 locale，没指定就容易翻车
• java 运行时一般不需要额外参数（JVM 读 class 字节码，不涉及源码编码），但若用 java -Dfile.encoding=GBK 强制改了，反而可能让 new String(bytes) 出问题

读写文件时别依赖平台默认编码，显式传 StandardCharsets.UTF_8

new FileInputStream("a.txt") 配 new Scanner(inputStream)，或者 Files.readAllLines(path)，这些 API 底层都偷偷用 Charset.defaultCharset()——它由 JVM 启动时系统环境决定，不可控。同一份代码，在 macOS 和 Windows 上行为不同是常态。

• 用 Files.readAllLines(path, StandardCharsets.UTF_8) 替代无参版本
• Scanner 构造时传编码：new Scanner(new FileInputStream("a.txt"), StandardCharsets.UTF_8)
• 写文件同理：Files.write(path, lines, StandardCharsets.UTF_8)，别用 PrintWriter 无参构造
• 注意 String.getBytes()：它也依赖默认编码，应写作 str.getBytes(StandardCharsets.UTF_8)

Spring Boot / Tomcat 启动时 HTTP 请求体和响应体的编码

Web 场景下，前端 POST 提交中文，后端 @RequestBody 接到乱码；或返回 JSON 里中文变成 \u4f60\u597d 或直接问号——这和源码编码无关，是 HTTP 层的字符集协商问题。

• Spring Boot 2.3+ 默认已设 server.servlet.encoding.charset=UTF-8 和 server.servlet.encoding.force=true，但老版本或自定义 TomcatServletWebServerFactory 时得手动配
• 确保请求头带 Content-Type: application/json;charset=UTF-8，否则 Spring 可能按 ISO-8859-1 解 body
• 响应头要含 Content-Type: application/json;charset=UTF-8，可通过 @RequestMapping(produces = "application/json;charset=UTF-8") 或全局配置 spring.http.encoding.force=true（旧版）
• 别信“浏览器自动识别”，Chrome 对无 charset 的响应一律当 ISO-8859-1 处理

理论要掌握，实操不能落！以上关于《Java设置UTF-8编码防乱码技巧》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！