JLabel/JButton组件HTML格式显示古吉拉特语Unicode文本异常

我之前处理过类似的Swing国际化渲染问题，你遇到的情况其实是Swing的HTML渲染引擎和普通文本渲染的机制差异导致的：直接用Unicode转义字符调用setText()时，Swing会自动检测字符集并匹配支持的字体，但HTML渲染器默认采用ISO-8859-1编码，且字体策略更保守，所以才会出现方块乱码。

下面给你几个可行的解决方案：

1. 在HTML头部指定UTF-8编码 #

Swing的HTML解析器默认不会自动识别Unicode字符的编码，所以需要在HTML代码里明确声明UTF-8，让渲染器正确解析古吉拉特语字符：

// 使用Unicode转义字符的写法
myJLabel.setText("<html><head><meta charset='UTF-8'></head><body>\u0aae\u0ac1\u0ab6\u0acd\u0a95\u0ac7\u0ab2\u0ac0</body></html>");

// 直接写古吉拉特语原文的写法（确保你的.java文件保存为UTF-8编码）
myJLabel.setText("<html><head><meta charset='UTF-8'></head><body>મુશ્કેલી</body></html>");

2. 强制指定支持古吉拉特语的字体 #

有时候即使编码正确，系统默认字体也可能不支持古吉拉特语的字形渲染，这时候需要在HTML里明确指定支持该语言的字体。推荐用开源的Noto Sans Gujarati（谷歌推出的多语言支持字体），也可以用系统自带的字体，比如Windows的Shruti、Linux的Lohit Gujarati：

// 用HTML font标签指定字体
myJLabel.setText("<html><head><meta charset='UTF-8'></head><body><font face='Noto Sans Gujarati'>\u0aae\u0ac1\u0ab6\u0acd\u0a95\u0ac7\u0ab2\u0ac0</font></body></html>");

// 或者用CSS内联样式更灵活
myJLabel.setText("<html><head><meta charset='UTF-8'></head><body><span style='font-family: \"Noto Sans Gujarati\", \"Shruti\", sans-serif;'>\u0aae\u0ac1\u0ab6\u0acd\u0a95\u0ac7\u0ab2\u0ac0</span></body></html>");

如果你的项目里没有打包对应字体，记得先确保目标系统已安装该字体，或者把字体文件嵌入到项目中加载。

3. 全局配置Swing组件的字体 #

如果你的整个应用都需要支持古吉拉特语，可以全局设置Swing组件的默认字体，这样所有HTML渲染的组件都会自动使用支持该语言的字体：

import java.awt.Font;
import javax.swing.UIManager;

// 在应用启动时调用
public static void setupGlobalFont() {
    Font gujaratiFont = new Font("Noto Sans Gujarati", Font.PLAIN, 12);
    UIManager.put("Label.font", gujaratiFont);
    UIManager.put("Button.font", gujaratiFont);
    // 其他需要支持的组件类型也可以在这里配置
}

为什么直接setText()正常？ #

Swing的普通文本渲染逻辑会自动扫描字符的Unicode范围，然后从系统字体中选择第一个能渲染该字符的字体；但HTML渲染器基于HTMLEditorKit，默认采用更严格的编码和字体匹配规则，不会自动 fallback 到合适的字体，所以必须手动配置。

内容的提问来源于stack exchange，提问作者DRAKU