JavaFX中无法应用自定义字体的问题求助

问题情况 #

用JavaFX开发桌面应用时，尝试通过CSS的@font-face为Label添加自定义字体，但字体未生效，不过-fx-text-fill属性正常工作。更换为系统自带字体（如Comic Sans MS）时，-fx-font-family能正常生效，排除属性本身的问题。

目录结构 #

项目目录大致如下：

src/
├── resources/
│   └── fonts/
│       └── LogoTypeGothic.otf
├── css/
│   └── 样式文件.css
└── ...（FXML及Java代码文件）

现有代码 #

CSS样式（自定义字体不生效版本） #

@font-face {
    font-family: 'LogoTypeGothic';
    src: url('../resources/fonts/LogoTypeGothic.otf');
}

.label {
    -fx-text-fill: #f6f6e9;
    -fx-font-family: "LogoTypeGothic";
}

CSS样式（系统字体生效版本） #

.label {
    -fx-text-fill: #f6f6e9;
    /*-fx-font-family: "LogoTypeGothic";*/
    -fx-font-family: "Comic Sans MS";
}

FXML代码片段 #

<children>
    <Label layoutX="92.0" layoutY="245.0" text="Username" />
    <Label layoutX="92.0" layoutY="292.0" prefHeight="20.0" prefWidth="58.0" text="Password" />
    <TextField layoutX="219.0" layoutY="241.0" prefHeight="23.0" prefWidth="134.0" />
    <PasswordField layoutX="219.0" layoutY="290.0" prefHeight="23.0" prefWidth="134.0" />
    <Button layoutX="146.0" layoutY="336.0" mnemonicParsing="false" prefHeight="39.0" prefWidth="137.0" text="Verify" />
</children>

解决方法 #

1. 修正CSS中的字体路径 #

JavaFX编译后，resources目录下的内容会被放到classpath根目录，所以CSS中的路径需要基于classpath根来写。如果你的CSS文件在src/css/，编译后会在classpath的css/目录下，那么字体的正确路径应该是绝对路径（以/开头）：

@font-face {
    font-family: 'LogoTypeGothic';
    src: url('/fonts/LogoTypeGothic.otf') format('opentype');
}

加上format('opentype')能帮助JavaFX正确识别字体格式，避免解析问题。

2. 在Java代码中预加载字体（更可靠） #

如果CSS加载字体失败，可以在应用启动时通过Java代码直接加载字体，确保字体被正确注册到系统中：

// 在Application的start方法里或者初始化阶段执行
Font customFont = Font.loadFont(getClass().getResourceAsStream("/fonts/LogoTypeGothic.otf"), 12);
// 确认字体是否加载成功
if (customFont != null) {
    System.out.println("字体加载成功");
} else {
    System.out.println("字体加载失败，请检查路径");
}

加载完成后，直接在CSS中使用-fx-font-family: "LogoTypeGothic";即可生效。

3. 检查文件名和大小写 #

在Linux/macOS系统中，文件路径是大小写敏感的，要确保CSS中写的文件名和实际字体文件名完全一致（包括大小写）。

4. 确认字体文件完整性 #

如果字体文件损坏或不完整，JavaFX无法加载，尝试重新下载或替换字体文件。

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