Java项目中文乱码解决方法大全

Java项目中文乱码问题并非偶然，而是源文件、编译器、JVM、IDE和终端五处编码不统一导致的连锁反应；本文直击根源，系统梳理了在IntelliJ IDEA中统一文件编码、通过Maven插件强制源码UTF-8编译、JVM启动时指定-Dfile.encoding=UTF-8、以及适配不同操作系统终端编码的完整解决方案——只要严格确保这五个环节全部锁定UTF-8，就能彻底告别乱码困扰，让中文从代码编写到控制台输出全程清晰无误。

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读取源文件。

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，中文就不会丢。漏掉任意一环，都可能在某个阶段突然乱码。

今天关于《Java项目中文乱码解决方法大全》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于的内容请关注golang学习网公众号！