Java环境搭建完成后出现乱码是开发过程中非常常见的问题，这类问题通常不是环境安装失败导致的，而是字符集配置不匹配引发的。Java程序在运行时涉及多个环节，包括源码文件编码、编译编码、运行时编码、系统默认编码等，任何一个环节的编码不一致都可能导致乱码。
常见乱码场景及原因
乱码通常出现在以下几个场景：
- 控制台输出中文变成问号或者乱码方块
- 读取本地文件的中文内容出现乱码
- 网络请求返回的中文数据解析错误
- 日志文件中记录的中文信息无法正常显示
这些场景的核心原因都是字符编码和解码使用的字符集不一致，Java默认会读取系统的字符集作为默认编码，如果系统字符集和程序使用的字符集不匹配，就会产生乱码。
系统环境变量配置
首先可以检查系统的JAVA_TOOL_OPTIONS环境变量，这个变量可以全局设置JVM的启动参数，适合所有Java程序生效。在Windows系统中，可以在系统环境变量中添加如下配置：
变量名：JAVA_TOOL_OPTIONS 变量值：-Dfile.encoding=UTF-8
在Linux或者macOS系统中，可以在~/.bashrc或者~/.zshrc中添加如下配置：
export JAVA_TOOL_OPTIONS="-Dfile.encoding=UTF-8"
配置完成后重启终端，让环境变量生效，之后运行的Java程序会默认使用UTF-8作为文件编码。
JVM启动参数设置
如果只想针对单个Java程序设置字符集，可以在启动JVM时添加-Dfile.encoding参数，指定程序运行时的默认字符集。例如运行一个jar包时，可以使用如下命令：
java -Dfile.encoding=UTF-8 -jar your_app.jar
如果需要指定更多字符集相关的参数，还可以添加如下参数：
-Dsun.jnu.encoding：设置JVM从系统获取文件名时使用的编码，默认和file.encoding一致，部分场景下需要单独设置-Duser.language：设置用户语言，例如zh代表中文-Duser.country：设置用户地区，例如CN代表中国
源码与编译编码统一
Java源码文件的编码需要和编译时指定的编码一致，否则编译后的class文件中的字符串会出现乱码。如果使用javac命令手动编译，需要添加-encoding参数指定源码编码：
// 源码文件Test.java使用UTF-8编码
public class Test {
public static void main(String[] args) {
System.out.println("中文测试");
}
}
// 编译时指定编码
javac -encoding UTF-8 Test.java
// 运行程序
java Test
如果使用构建工具比如Maven，可以在pom.xml中配置编译编码：
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.8.1</version>
<configuration>
<source>1.8</source>
<target>1.8</target>
<encoding>UTF-8</encoding>
</configuration>
</plugin>
</plugins>
</build>
IDE配置调整
如果使用IDE开发Java程序，还需要检查IDE的编码配置，避免IDE的编码和JVM的编码不一致。以IntelliJ IDEA为例，需要检查以下几个位置的配置：
- 打开File - Settings - Editor - File Encodings，将Global Encoding、Project Encoding、Default encoding for properties files都设置为UTF-8，并勾选Transparent native-to-ascii conversion
- 打开Run - Edit Configurations，在VM options中添加
-Dfile.encoding=UTF-8 - 检查IDE的控制台编码，确保控制台的默认编码也是UTF-8
文件读写时的编码指定
在程序中读写文件时，不要依赖默认字符集，最好显式指定字符集，避免不同环境下默认字符集不一致导致乱码。例如读取文件时：
import java.io.BufferedReader;
import java.io.FileInputStream;
import java.io.InputStreamReader;
import java.nio.charset.StandardCharsets;
public class ReadFileDemo {
public static void main(String[] args) throws Exception {
// 显式指定UTF-8编码读取文件
try (BufferedReader br = new BufferedReader(
new InputStreamReader(
new FileInputStream("test.txt"), StandardCharsets.UTF_8))) {
String line;
while ((line = br.readLine()) != null) {
System.out.println(line);
}
}
}
}
写入文件时同样需要指定编码：
import java.io.BufferedWriter;
import java.io.FileOutputStream;
import java.io.OutputStreamWriter;
import java.nio.charset.StandardCharsets;
public class WriteFileDemo {
public static void main(String[] args) throws Exception {
// 显式指定UTF-8编码写入文件
try (BufferedWriter bw = new BufferedWriter(
new OutputStreamWriter(
new FileOutputStream("output.txt"), StandardCharsets.UTF_8))) {
bw.write("中文内容测试");
}
}
}
字符集配置验证方法
可以通过如下代码验证当前Java程序的默认字符集配置：
import java.nio.charset.Charset;
public class CharsetCheck {
public static void main(String[] args) {
// 打印默认字符集
System.out.println("默认字符集：" + Charset.defaultCharset());
// 打印file.encoding配置
System.out.println("file.encoding：" + System.getProperty("file.encoding"));
// 打印sun.jnu.encoding配置
System.out.println("sun.jnu.encoding：" + System.getProperty("sun.jnu.encoding"));
}
}
运行这段代码可以查看当前程序的字符集配置是否符合预期，如果输出的字符集不是UTF-8，就需要按照前面的步骤调整配置。
常见问题排查思路
如果调整配置后仍然存在乱码，可以按照以下思路排查：
- 先运行字符集验证代码，确认JVM的默认字符集是否正确
- 检查源码文件的编码是否和编译时指定的编码一致
- 检查读写文件时是否显式指定了字符集
- 检查IDE的配置是否和系统环境变量、JVM参数一致
- 如果是网络请求相关的乱码，检查请求和响应的Content-Type中是否指定了正确的字符集