IDEA控制台日志中文乱码如何解决？

Question

在使用IntelliJ IDEA开发Java项目时，控制台输出日志中出现中文乱码是常见问题，尤其在Windows系统下更为明显。该问题通常由IDEA控制台的字符编码与项目文件编码不一致导致，例如项目使用UTF-8编码，而控制台默认采用GBK或Cp1252编码，致使中文无法正确解析显示。如何统一配置IDEA的文件编码与控制台输出编码，确保日志中的中文内容正常显示，成为开发者频繁遇到的技术难题。

Answer 1

一、问题背景与现象描述

在使用IntelliJ IDEA开发Java项目时，控制台输出日志中出现中文乱码是常见问题，尤其在Windows系统下更为明显。该问题通常由IDEA控制台的字符编码与项目文件编码不一致导致。例如，项目源码文件采用UTF-8编码格式，而IntelliJ IDEA的运行控制台默认使用操作系统的本地编码（如Windows平台的GBK或Cp1252），从而造成中文字符无法正确解析和显示。

这种乱码现象不仅影响日志可读性，还可能误导开发者对程序运行状态的判断，特别是在调试多语言支持功能或处理用户输入中文内容时尤为突出。

二、编码基础概念梳理

• UTF-8：一种变长Unicode编码方式，兼容ASCII，广泛用于现代Web应用和国际化项目。
• GBK：中国国家标准汉字内码扩展规范，主要用于简体中文环境，Windows中文系统默认编码之一。
• Cp1252：即Windows-1252，西欧语言编码，部分英文版Windows系统默认使用此编码。
• File Encoding：指源代码文件保存时使用的字符集。
• Console Encoding：指IDE运行程序时输出流所使用的字符集。

当File Encoding为UTF-8而Console Encoding为非UTF-8时，System.out.println("中文")这类语句就会出现乱码。

三、诊断流程图

graph TD
    A[控制台输出中文乱码] --> B{检查项目文件编码}
    B -->|File Encoding ≠ UTF-8| C[统一设为UTF-8]
    B -->|File Encoding = UTF-8| D{检查IDEA控制台编码}
    D -->|Console Encoding ≠ UTF-8| E[修改Run Configuration编码]
    D -->|Console Encoding = UTF-8| F{检查JVM启动参数}
    F --> G[添加-Dfile.encoding=UTF-8]
    G --> H[重启IDE并测试]
    

四、解决方案层级递进

1. 步骤一：统一项目文件编码

   设置项	路径	推荐值
   Global Encoding	Settings → Editor → File Encodings	UTF-8
   Project Encoding	同上	UTF-8
   Default encoding for properties files	同上	UTF-8

2. 步骤二：配置运行环境编码 进入 Run/Debug Configurations，在 VM options 中添加：

   -Dfile.encoding=UTF-8

   此参数强制JVM以UTF-8解析所有字符流。
3. 步骤三：调整IDEA全局控制台输出编码 在 Help → Edit Custom VM Options... 中添加：

   -Dconsole.encoding=UTF-8

   注意：某些版本需通过注册表启用（idea.properties 文件中设置）。
4. 步骤四：操作系统层面兼容处理 对于Windows CMD终端遗留问题，可在命令行启动IDEA前执行：

   chcp 65001

   将活动代码页切换为UTF-8模式。

五、高级场景分析

在微服务架构或多模块Maven项目中，若子模块未继承主POM的资源过滤配置，可能导致resources/*.properties文件读取时发生编码转换错误。建议在pom.xml中显式声明：

<properties>
    <maven.compiler.source>17</maven.compiler.source>
    <maven.compiler.target>17</maven.compiler.target>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
</properties>

同时配合Maven Resources Plugin确保资源复制时不丢失编码信息：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-resources-plugin</artifactId>
    <version>3.3.0</version>
    <configuration>
        <encoding>UTF-8</encoding>
    </configuration>
</plugin>

六、验证与自动化检测脚本

编写一个简单的Java类用于验证当前环境是否解决乱码问题：

public class EncodingTest {
    public static void main(String[] args) {
        System.out.println("当前文件编码: " + java.nio.charset.Charset.defaultCharset());
        System.out.println("JVM file.encoding: " + System.getProperty("file.encoding"));
        System.out.println("测试中文输出：你好，世界！");
    }
}

预期输出结果应为清晰可读的中文，并显示UTF-8作为默认编码。