Java项目中文乱码的根本原因是编码配置不统一,需确保源文件、编译器、JVM、IDE、终端五者编码均为UTF-8:1. IDEA中设置Global/Project/Properties编码为UTF-8并勾选转义;2. Maven配置maven-compiler-plugin的encoding为UTF-8;3. JVM启动时加-Dfile.encoding=UTF-8;4. 终端需设为UTF-8(如Windows执行chcp 65001)。

Java项目中出现中文乱码,根本原因通常是编码配置不统一。关键不是“改一个地方”,而是确保源文件编码、编译器编码、运行时JVM编码、IDE编码、控制台/终端编码五者一致(推荐统一为UTF-8)。
1. 设置IDE(以IntelliJ IDEA为例)的默认编码
这是最常被忽略的一环。IDE默认可能用系统编码(如Windows的GBK),导致.java文件保存时就已乱码。
- File → Settings → Editor → File Encodings
- 将Global Encoding、Project Encoding、Default encoding for properties files 全部设为 UTF-8
- 勾选 Transparent native-to-ascii conversion(对properties文件中的中文自动转\uXXXX,避免部署时出错)
2. 配置Maven编译插件指定源码编码
即使IDE用了UTF-8,Maven默认可能按平台编码编译,导致class文件里字符串字面量出错。
- 在pom.xml中添加maven-compiler-plugin配置:
org.apache.maven.plugins maven-compiler-plugin 3.11.0 8 8 UTF-8
注意: 是关键,它告诉javac用UTF-8读取源文件。
立即学习“Java免费学习笔记(深入)”;
小麦企业网站展示系统介绍:一、安装使用将xiaomai.sql导入数据库二、后台登录后台帐号,密码默认都是admin,config.php 配置文件可根据自行需要修改,IP地址,数据库用户名,密码,及表名后台目录默认admin,支持自行任意修改目录名三、注意事项1 本源码完全免费,采用伪静态,减少不必要的源码重复,速度更快,支持二次开发。2、注明本程序编码为UTF8,如发生乱码,请注意修改编码3、
3. 启动JVM时指定file.encoding
Java程序运行时,String.getBytes()、new String(byte[])等操作依赖JVM启动参数-Dfile.encoding。不指定则取操作系统默认值(Windows常为GBK)。
- 运行jar包时加参数:
java -Dfile.encoding=UTF-8 -jar app.jar - 在IDE运行配置中(Run → Edit Configurations → VM options)添加:
-Dfile.encoding=UTF-8 - Spring Boot项目可在application.properties中加:
server.tomcat.uri-encoding=UTF-8(仅对HTTP请求参数有效,不影响JVM全局)
4. 控制台/终端输出乱码?检查终端本身
即使代码全UTF-8,Windows命令行(cmd)默认是GBK,打印中文仍显示为乱码。
- Windows:在cmd中执行
chcp 65001切换为UTF-8(临时生效);或改用Windows Terminal + 设置字体支持Unicode - Mac/Linux:终端一般默认UTF-8,但可检查:
locale | grep UTF,确保LANG含UTF-8 - IDE内置Terminal:在IDE设置中找到Terminal → Shell path,勾选“Override IDE encoding with”并设为UTF-8
基本上就这些。核心逻辑很简单:从文件保存→编译→加载→运行→输出,每个环节都走UTF-8,中文就不会丢。漏掉任意一环,都可能在某个阶段突然乱码。









