自定义字体不显示/极小？使用Google Fonts遇FontFormatException问题

看起来你在Java Swing应用里使用Google Fonts时踩了坑——触发FontFormatException: Problem reading font data，还导致文本显示极小、窗口只剩细黑线，多款字体都出现这个问题。我之前也碰到过类似情况，大概率是字体加载方式不对或者格式不兼容，给你整理了可行的解决步骤：

1. 先拿到正确格式的字体文件 #

Google Fonts网页上的字体是woff/woff2格式（给网页用的），但Java Swing只支持**TrueType(.ttf)或OpenType(.otf)**格式，这是核心问题之一：

• 打开Google Fonts官网，找到你要的字体，点击「Download family」下载完整字体包
• 解压后在文件夹里找到后缀为.ttf（或.otf）的文件，把它放到项目的资源目录里（比如src/main/resources/fonts/）

2. 正确加载字体文件 #

Java不能直接用网络链接加载字体，必须读取本地字体文件的输入流，而且要处理好异常和资源释放。给你一个封装好的加载方法：

private Font loadCustomFont(String fontResourcePath) {
    // 使用try-with-resources自动关闭输入流，避免资源泄漏
    try (InputStream fontStream = getClass().getResourceAsStream(fontResourcePath)) {
        if (fontStream == null) {
            throw new IOException("找不到字体文件：" + fontResourcePath);
        }
        // 加载基础字体（默认大小是1pt，所以后面要调整）
        Font baseFont = Font.createFont(Font.TRUETYPE_FONT, fontStream);
        // 派生设置合适的字体大小，比如12pt
        return baseFont.deriveFont(12f);
    } catch (FontFormatException | IOException e) {
        e.printStackTrace();
        // 加载失败时回退到系统默认字体，避免界面崩掉
        return new Font(Font.SANS_SERIF, Font.PLAIN, 12);
    }
}

然后在你的View构造函数里调用这个方法：

public View() {
    // 假设字体文件放在resources/fonts/下，路径要对应
    font = loadCustomFont("/fonts/YourFont-Regular.ttf");
    initUI(); // 初始化你的UI组件
}

3. 正确设置组件字体并修复布局 #

之前的细黑线问题，大概率是因为字体大小没设置（默认1pt），加上布局管理器没配置好，导致标签被压缩：

private void initUI() {
    content = new JPanel();
    // 给面板设置合适的布局管理器，比如BorderLayout，避免组件被挤压
    content.setLayout(new BorderLayout());
    
    JLabel yourLabel = new JLabel("测试文本");
    yourLabel.setFont(font); // 给标签设置加载好的字体
    content.add(yourLabel, BorderLayout.CENTER);
    
    this.setContentPane(content);
    this.setSize(400, 300); // 设置窗口大小
    this.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
    this.setVisible(true);
}

额外排查点 #

• 检查字体路径：getResourceAsStream的路径要和文件在classpath中的位置对应，比如放在resources/fonts/下，路径就是/fonts/xxx.ttf
• 确认字体文件完整：如果下载的字体包损坏，也会触发读取异常，重新下载一次试试
• 不要直接用网络链接：Java的Font.createFont不支持直接读取网络字体流，必须下载到本地再加载

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