一、韩文乱码的根源解析

Java Swing的韩文乱码问题本质上是字符编码与字体渲染的冲突。当系统环境、JVM配置或组件属性与韩文字符编码（如EUC-KR或UTF-8）不匹配时，Swing组件无法正确解析韩文字符的二进制编码，导致显示为乱码或方框。

1.1 编码传递链的断裂

Swing组件的文本渲染依赖三重编码传递：

• 源代码编码：IDE保存.java文件时的编码方式
• JVM默认编码：通过Charset.defaultCharset()获取的系统编码
• 组件渲染编码：JLabel/JTextField等组件的字体映射表

若源代码使用UTF-8编码，但JVM默认编码为ISO-8859-1，且组件未指定支持韩文的字体，则编码传递链在JVM层断裂，导致乱码。

1.2 字体支持的缺失

Swing的默认字体（如Dialog、SansSerif）可能不包含韩文字形。当组件尝试渲染韩文字符时，若字体库中无对应字形，会显示为缺失字符符号（□）。

二、系统性解决方案

2.1 统一项目编码规范

步骤1：在IDE中统一使用UTF-8编码

• IntelliJ IDEA：File → Settings → Editor → File Encodings → 全局设置UTF-8
• Eclipse：Window → Preferences → General → Workspace → Text file encoding → UTF-8

步骤2：编译时指定编码

javac -encoding UTF-8 Main.java

验证点：通过Charset.defaultCharset()检查JVM当前编码

System.out.println("Default Charset: " + Charset.defaultCharset());
System.out.println("File.encoding: " + System.getProperty("file.encoding"));

2.2 显式设置组件字体

方案A：使用系统支持韩文的字体（如Windows的Malgun Gothic）

JLabel label = new JLabel("한글 테스트");
Font koreanFont = new Font("Malgun Gothic", Font.PLAIN, 12);
label.setFont(koreanFont);

方案B：嵌入支持韩文的字体文件（适用于跨平台场景）

try {
    InputStream is = getClass().getResourceAsStream("/fonts/NotoSansCJKkr-Regular.otf");
    Font font = Font.createFont(Font.TRUETYPE_FONT, is);
    font = font.deriveFont(Font.PLAIN, 12);
    label.setFont(font);
} catch (Exception e) {
    e.printStackTrace();
}

2.3 强制JVM使用UTF-8编码

在启动JVM时添加编码参数：

java -Dfile.encoding=UTF-8 Main

或通过代码动态设置（需在组件初始化前执行）：

try {
    Field charsetField = Class.forName("java.nio.charset.Charset").getDeclaredField("defaultCharset");
    charsetField.setAccessible(true);
    charsetField.set(null, Charset.forName("UTF-8"));
} catch (Exception e) {
    e.printStackTrace();
}

三、典型场景解决方案

3.1 JTable中的韩文显示

问题现象：表格单元格显示韩文乱码

解决方案：

// 设置表格渲染器字体
DefaultTableCellRenderer renderer = new DefaultTableCellRenderer() {
    @Override
    public Component getTableCellRendererComponent(JTable table, Object value, 
            boolean isSelected, boolean hasFocus, int row, int column) {
        Component c = super.getTableCellRendererComponent(table, value, 
                isSelected, hasFocus, row, column);
        if (c instanceof JLabel) {
            ((JLabel) c).setFont(new Font("Malgun Gothic", Font.PLAIN, 12));
        }
        return c;
    }
};
table.setDefaultRenderer(Object.class, renderer);

3.2 JTextField输入韩文

问题现象：输入韩文时显示为问号

解决方案：

JTextField field = new JTextField();
field.setFont(new Font("Gulim", Font.PLAIN, 14)); // Gulim是Windows常用韩文字体
// 监听输入验证
field.getDocument().addDocumentListener(new DocumentListener() {
    @Override
    public void insertUpdate(DocumentEvent e) {
        checkKoreanInput(field);
    }
    // 其他方法实现...
});
private void checkKoreanInput(JTextField field) {
    String text = field.getText();
    for (char c : text.toCharArray()) {
        if (c < 0xAC00 || c > 0xD7AF) { // 韩文字符Unicode范围
            // 可添加提示逻辑
        }
    }
}

四、跨平台兼容性处理

4.1 字体回退机制

GraphicsEnvironment ge = GraphicsEnvironment.getLocalGraphicsEnvironment();
String[] fontNames = ge.getAvailableFontFamilyNames();
Font koreanFont = null;
for (String name : fontNames) {
    if (name.contains("Gothic") || name.contains("Gulim") || name.contains("Noto")) {
        koreanFont = new Font(name, Font.PLAIN, 12);
        break;
    }
}
if (koreanFont == null) {
    // 使用备用字体并记录警告
    koreanFont = new Font("Dialog", Font.PLAIN, 12);
    System.err.println("Warning: No Korean font found, using fallback");
}

4.2 动态加载字体资源

将字体文件（如.ttf）放入项目resources目录，运行时加载：

public static Font loadKoreanFont(String resourcePath, float size) {
    try (InputStream is = ClassLoader.getSystemResourceAsStream(resourcePath)) {
        Font font = Font.createFont(Font.TRUETYPE_FONT, is);
        return font.deriveFont(size);
    } catch (Exception e) {
        System.err.println("Failed to load Korean font: " + e.getMessage());
        return new Font("Dialog", Font.PLAIN, (int)size);
    }
}

五、最佳实践建议

1. 编码声明标准化：在.java文件顶部添加编码声明

   // -*- coding: UTF-8 -*-

2. 字体资源管理：将韩文字体文件打包到JAR中，通过getResourceAsStream加载

3. 异常处理完善：对字体加载失败的情况提供优雅降级方案

4. 测试用例覆盖：编写包含韩文字符的UI测试用例，验证不同操作系统下的显示效果

5. 文档化配置：在项目README中明确说明编码和字体配置要求

通过系统性地处理编码传递链、显式设置字体属性、强制JVM使用UTF-8编码，并针对不同组件场景实施定制化解决方案，开发者可彻底解决Java Swing中的韩文乱码问题。实践表明，结合字体回退机制和动态资源加载，能实现99%以上的跨平台兼容性。