JavaFX使用自定义字体时按钮内文字无法居中如何解决

算力阿峰

2026-8-28

问题根因

这个问题是字体本身元数据不规范导致的，和JavaFX本身逻辑无关。
JavaFX对按钮、标签这类带文字的组件做布局计算时，会严格读取字体文件内置的度量参数：上伸高度（Ascender，字符基线到字体最高处的距离）、下伸高度（Descender，字符基线到字体最低处的距离）、行间距（LineGap），最终根据这三个值计算组件的最小高度、文字垂直居中的偏移量。
你用的Another Danger是装饰类海报字体，当前引入的Demo版本在制作时没有校准这些核心度量参数，参数值偏差极大，JavaFX按照字体规范读取参数计算布局，自然会出现文字偏移、组件尺寸异常的问题。切回系统默认字体后参数符合规范，布局就恢复正常，和观察到的现象完全匹配。

最小复现代码如下：

public class HelloApplication extends Application {
    public static void main(String[] args) {
        launch();
    }

    @Override
    public void start(Stage stage) {
        Button button = new Button("Test");
        Scene scene = new Scene(button, 320, 240);
        button.setFont(Font.loadFont(HelloApplication.class.getResourceAsStream("/fonts/AnotherDanger-Demo.otf"), 30));
        stage.setTitle("Hello!");
        stage.setScene(scene);
        stage.show();
    }
}

效果对比如下：

加载该自定义字体的异常显示效果：
使用系统默认字体的正常显示效果：

修复方案

按优先级从高到低排列：

替换为正式版字体
你现在用的是免费Demo版字体，这类版本本身就不做生产可用性校验，普遍存在元数据错误、字符集不全的问题。如果是正式项目，直接购买该字体的正式商用版本，官方发布的正式版都会修正这类基础元数据问题，不需要额外修改业务代码。
手动修正字体元数据
如果仅做非商用测试，可以用开源字体编辑工具FontForge自行修正参数：
1. 用FontForge打开本地的AnotherDanger-Demo.otf文件
2. 进入元素 > 字体信息 > OS/2 > 度量面板，调整Typo Ascent、Typo Descent、Win Ascent、Win Descent、HHead Ascent、HHead Descent几个参数到合理范围（30号字场景下一般Ascent设为25左右、Descent设为-5左右即可，可边调整边预览效果）
3. 勾选「使用Typo度量值计算行高」选项后，导出为新的字体文件替换原有资源即可
代码层面强制调整布局
临时应急的话，可以不用改字体文件，直接给用到该字体的组件手动设置内边距、微调偏移量：
```
// 针对30号字的Another Danger字体手动适配内边距
button.setPadding(new Insets(8, 14, 2, 14));
// 若垂直位置仍有偏差，可额外设置Y轴偏移微调
// button.lookup(".text").setTranslateY(1);
```
这个方案的缺点是适配参数和字号强绑定，字号调整后所有参数都要重新校准，维护成本很高，不建议在大规模使用该字体的场景下用。

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