在Ubuntu系统上进行Java开发时，编译或运行程序遇到中文字符乱码，是许多开发者都会碰到的常见问题。不必焦虑，这个问题通常有明确的排查和解决流程。核心原则其实很简单：确保整个开发环境的字符编码设置保持一致。无论是源代码文件、Java编译器（javac），还是Java虚拟机（JVM）运行时，只要它们的字符编码统一，乱码问题大多都能顺利解决。
一、快速诊断乱码问题的根源
在着手修复之前，准确判断乱码发生在哪个环节至关重要。盲目调整设置可能会让问题更复杂。
- 检查源代码文件的真实编码：这是首要步骤。在Ubuntu终端中运行命令
file -i YourFile.java，查看输出结果是否为 UTF-8 或 GBK 等。例如，执行file -i Hello.java可以明确该文件的实际编码格式。 - 查看系统区域与语言设置：运行
locale命令。理想的输出应包含“UTF-8”字样，例如en_US.UTF-8或zh_CN.UTF-8。如果此处不是UTF-8，那么终端本身的输出就可能出现乱码。 - 区分两种主要的乱码类型：
- 编译时或运行时控制台输出乱码：这通常是由于源代码文件的编码（例如GBK）与编译或运行时JVM采用的默认编码（例如UTF-8）不匹配所导致。
- 图形用户界面（GUI）显示“□□□”或方块：这通常是Swing或JavaFX等图形界面库的问题，根源在于当前JDK/JRE环境中缺少可用的中文字体，或者字体回退机制未能正确配置。
二、编译与运行时乱码的通用解决方案
针对上述第一类控制台乱码，解决方法直接有效：在各个环节显式指定字符编码，使其保持一致。
- 编译时指定源文件编码：使用
javac -encoding参数。若源文件编码为UTF-8，则执行javac -encoding UTF-8 YourProgram.java；若为GBK，则执行javac -encoding GBK YourProgram.java。 - 运行时指定JVM默认文件编码：使用
java -Dfile.encoding参数。例如，java -Dfile.encoding=UTF-8 YourProgram。同样，需根据源文件编码进行相应调整。 - 建立统一的编码规范：长远来看，最佳实践是将所有源代码、编译过程以及运行环境的编码统一设置为 UTF-8。这能有效避免在跨平台开发或团队协作时产生编码冲突。
- 在代码中读写文件时显式指定字符集：编写Java程序时，应避免依赖操作系统的默认编码。推荐使用如
new InputStreamReader(new FileInputStream(“in.txt”), StandardCharsets.UTF_8)的方式，明确指定字符集。 - 在构建工具中统一配置编码：如果使用Maven、Gradle等自动化构建工具，务必在对应的配置文件（如pom.xml、build.gradle）中为编译插件统一设置编码参数。这能确保无论在命令行还是IDE中，编译行为都是一致的。
三、系统与全局环境层面的配置调整
有时，乱码问题源于更深层的系统环境设置。调整这些全局配置可以一劳永逸，但需注意其影响范围。
- 将系统区域设置调整为 UTF-8：
- 临时生效（仅对当前终端会话有效）：执行
export LANG=en_US.UTF-8; export LC_CTYPE=en_US.UTF-8; export LC_ALL=en_US.UTF-8。 - 永久生效：可以运行
sudo update-locale LANG=en_US.UTF-8，或者直接编辑系统配置文件如/etc/default/locale或/etc/environment。
- 临时生效（仅对当前终端会话有效）：执行
- 设置Java全局环境变量：通过
export JAVA_TOOL_OPTIONS=-Dfile.encoding=UTF-8，可以为当前会话中启动的所有Java应用程序设置默认编码。使用时需注意，避免与程序内部显式指定的编码产生冲突。 - 应用服务器（如Tomcat）配置：对于Tomcat等Web容器，可以在其启动脚本（如catalina.sh或setenv.sh）中添加：
JAVA_OPTS=“$JAVA_OPTS -Dfile.encoding=UTF-8”。
四、解决GUI界面中文显示为方块的问题
这是另一个典型场景，其根源在于字体缺失，而非纯文本编码问题。
- 为Ubuntu系统安装中文字体：首先确保系统中已安装可用的中文字体。安装文泉驿字体是一个简单可靠的选择：
sudo apt-get install fonts-wqy-zenhei。 - 为JDK配置字体回退目录：这是关键步骤，用于告知JDK在何处查找中文字体。
- 进入你的JDK字体目录：
cd $JAVA_HOME/jre/lib/fonts（对于OpenJDK 11及以上版本，路径可能为$JAVA_HOME/lib/fonts）。 - 创建字体回退目录并复制中文字体：
sudo mkdir fallback；sudo cp /usr/share/fonts/truetype/wqy/* fallback/。 - 生成字体索引文件：依次执行
sudo mkfontdir和sudo mkfontscale。
- 进入你的JDK字体目录：
- 旧版Oracle JDK的特殊处理：如果使用的是较旧的Oracle JDK，且图形界面依然显示异常，可以尝试在JRE的
fonts目录下创建fallback文件夹，并将系统字体文件（如simsun.ttc）链接或复制进去，然后同样执行mkfontdir和mkfontscale命令重建索引。
五、常见问题场景与对应命令速查
为了方便快速参考，以下汇总了典型场景下的命令示例：
- 源文件编码为 UTF-8：
- 编译命令：
javac -encoding UTF-8 App.java - 运行命令：
java -Dfile.encoding=UTF-8 App
- 编译命令：
- 源文件编码为 GBK：
- 编译命令：
javac -encoding GBK App.java - 运行命令：
java -Dfile.encoding=GBK App
- 编译命令：
- 批量转换源代码文件编码（例如从GBK转换为UTF-8）：
- 使用工具转换：
iconv -f GBK -t UTF-8 -o App_utf8.java App_gbk.java - 转换完成后，使用UTF-8编码进行后续的编译和运行。
- 使用工具转换：
- 构建工具配置示例（Maven）：在pom.xml文件的maven-compiler-plugin插件配置中设置编码：
UTF-8
总而言之，解决Ubuntu系统下Java中文乱码问题，本质上是一个不断“对齐”和“统一”编码环境的过程。遵循上述从问题定位到分步修复的流程，基本能够覆盖绝大多数开发场景。始终保持开发环境中字符编码的一致性，是预防此类问题的根本之道。
