Java Swing文本编辑器：为不支持字符切换字体的实现方法

我之前也遇到过类似的需求——想用偏好的等宽字体显示大部分文本，同时让不支持的Unicode字符自动 fallback 到合适的字体。下面是具体的实现思路和代码：

首先，JTextArea本身不支持多字体渲染，因为它默认使用PlainDocument，只能全局设置一种字体。所以我们需要换成JTextPane（它默认使用StyledDocument，支持给不同文本片段设置不同样式）。

接下来，核心是两个点：

• 判断字符是否能被目标字体（Consolas）渲染
• 给不支持的字符自动应用 fallback 字体

步骤1：工具方法判断字体是否支持字符 #

Java的Font类提供了canDisplay(char c)方法，可以直接检查某个字符是否能被该字体正常渲染。我们封装一个工具方法：

private boolean isCharSupported(Font font, char c) {
    return font.canDisplay(c);
}

步骤2：配置主字体和Fallback字体 #

定义我们想要的主字体和备选字体（选一个系统自带的Unicode兼容字体即可）：

Font mainFont = new Font("Consolas", Font.PLAIN, 12);
Font fallbackFont = new Font("MS Gothic", Font.PLAIN, 12); // Windows可选MS Gothic，macOS可选Hiragino Sans，Linux可选Noto Sans

步骤3：自定义DocumentFilter自动处理字体样式 #

为了让插入文本时自动应用正确的字体，我们可以给StyledDocument添加一个DocumentFilter，在文本插入或替换时，自动检查每个字符并设置对应的样式：

import javax.swing.*;
import javax.swing.text.*;
import java.awt.*;

public class MixedFontTextEditor extends JFrame {
    private JTextPane textPane;
    private Font mainFont;
    private Font fallbackFont;
    private Style mainStyle;
    private Style fallbackStyle;

    public MixedFontTextEditor() {
        // 初始化字体和样式
        mainFont = new Font("Consolas", Font.PLAIN, 12);
        fallbackFont = new Font("MS Gothic", Font.PLAIN, 12);
        
        textPane = new JTextPane();
        StyledDocument doc = textPane.getStyledDocument();
        
        // 创建主样式和 fallback 样式
        mainStyle = doc.addStyle("MainStyle", null);
        StyleConstants.setFontFamily(mainStyle, mainFont.getFamily());
        StyleConstants.setFontSize(mainStyle, mainFont.getSize());
        
        fallbackStyle = doc.addStyle("FallbackStyle", null);
        StyleConstants.setFontFamily(fallbackStyle, fallbackFont.getFamily());
        StyleConstants.setFontSize(fallbackStyle, fallbackFont.getSize());

        // 设置DocumentFilter处理文本插入/替换
        AbstractDocument abstractDoc = (AbstractDocument) doc;
        abstractDoc.setDocumentFilter(new DocumentFilter() {
            @Override
            public void insertString(FilterBypass fb, int offset, String string, AttributeSet attr) throws BadLocationException {
                applyMixedFontStyle(fb, offset, string);
            }

            @Override
            public void replace(FilterBypass fb, int offset, int length, String text, AttributeSet attrs) throws BadLocationException {
                fb.remove(offset, length);
                applyMixedFontStyle(fb, offset, text);
            }

            private void applyMixedFontStyle(FilterBypass fb, int offset, String text) throws BadLocationException {
                StyledDocument doc = (StyledDocument) fb.getDocument();
                int currentOffset = offset;

                // 遍历文本，批量处理连续同样式的字符
                for (int i = 0; i < text.length(); i++) {
                    char c = text.charAt(i);
                    Style style = isCharSupported(mainFont, c) ? mainStyle : fallbackStyle;
                    
                    // 找到连续相同样式的字符段
                    int end = i;
                    while (end < text.length() && isCharSupported(mainFont, text.charAt(end)) == (style == mainStyle)) {
                        end++;
                    }
                    String segment = text.substring(i, end);
                    fb.insertString(currentOffset, segment, style);
                    currentOffset += segment.length();
                    i = end - 1;
                }
            }
        });

        // 初始化界面
        add(new JScrollPane(textPane));
        setSize(800, 600);
        setDefaultCloseOperation(EXIT_ON_CLOSE);
        setVisible(true);
    }

    private boolean isCharSupported(Font font, char c) {
        return font.canDisplay(c);
    }

    public static void main(String[] args) {
        SwingUtilities.invokeLater(MixedFontTextEditor::new);
    }
}

步骤4：处理已有文本 #

如果需要对已有的文本重新应用字体样式，可以添加一个方法遍历整个文档：

private void reapplyFontStyle() {
    StyledDocument doc = textPane.getStyledDocument();
    try {
        String content = doc.getText(0, doc.getLength());
        doc.remove(0, doc.getLength());
        applyMixedFontStyle(doc, 0, content);
    } catch (BadLocationException e) {
        e.printStackTrace();
    }
}

// 补充支持直接操作Document的样式应用方法
private void applyMixedFontStyle(StyledDocument doc, int offset, String text) throws BadLocationException {
    int currentOffset = offset;
    for (int i = 0; i < text.length(); i++) {
        char c = text.charAt(i);
        Style style = isCharSupported(mainFont, c) ? mainStyle : fallbackStyle;
        
        int end = i;
        while (end < text.length() && isCharSupported(mainFont, text.charAt(end)) == (style == mainStyle)) {
            end++;
        }
        String segment = text.substring(i, end);
        doc.insertString(currentOffset, segment, style);
        currentOffset += segment.length();
        i = end - 1;
    }
}

补充说明 #

• 关于fallback字体的选择：可以用Font.decode(null)获取系统默认字体作为备选，这样能更好地适配不同操作系统。
• 如果坚持想用JTextArea，需要自定义Painter重绘文本，实现起来复杂得多，不如直接用JTextPane更简单可靠。

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