JavaFX中阿拉伯字母完全不显示问题排查

你的FXML文件里TableColumn的阿拉伯文标题在MacOS运行时完全不显示，核心原因是JavaFX默认字体不支持阿拉伯文字形——哪怕文件编码已经设为UTF-8，字体缺失对应字形依然会导致文字无法渲染。

具体原因 #

• MacOS上JavaFX默认采用的系统字体（如San Francisco）通常不包含完整的阿拉伯文字形集，无法渲染阿拉伯字符。
• JavaFX 8对非拉丁文字符的渲染支持相对有限，这也可能加剧问题。

解决方案 #

1. 在FXML中直接指定支持阿拉伯文的字体

给TableColumn或整个TableView添加样式，指定支持阿拉伯文的字体（比如MacOS自带的Amiri或Noto Naskh Arabic）：

<!-- 给单个列设置字体 -->
<TableColumn prefWidth="75.0" text="الرصيد">
    <style>
        -fx-font-family: "Amiri";
    </style>
</TableColumn>

<!-- 给整个TableView统一设置字体 -->
<TableView layoutX="54.0" layoutY="136.0" prefHeight="200.0" prefWidth="495.0">
    <style>
        -fx-font-family: "Noto Naskh Arabic";
    </style>
    <columns>
        <TableColumn prefWidth="75.0" text="الرصيد" />
        <TableColumn prefWidth="75.0" text="ملاحظات" />
        <TableColumn prefWidth="75.0" text="دائن" />
        <TableColumn prefWidth="75.0" text="مدين" />
        <TableColumn prefWidth="75.0" text="التاريخ" />
    </columns>
</TableView>

2. 在Java代码中全局配置字体

如果希望整个应用都支持阿拉伯文，可以在启动类的start方法中设置全局字体：

@Override
public void start(Stage primaryStage) throws IOException {
    // 方式1：加载自定义字体文件（需将字体文件放在resources/fonts目录下）
    Font.loadFont(getClass().getResourceAsStream("/fonts/NotoNaskhArabic-Regular.ttf"), 12);
    // 方式2：指定系统自带的支持阿拉伯文的字体
    System.setProperty("javafx.font.family", "Amiri");

    // 加载FXML并显示界面
    Parent root = FXMLLoader.load(getClass().getResource("your-filename.fxml"));
    primaryStage.setScene(new Scene(root));
    primaryStage.show();
}

3. 升级JavaFX版本

JavaFX 8对非拉丁文字符的支持不够完善，建议升级到JavaFX 17或更高版本，新版本对阿拉伯文等RTL（从右到左）语言的渲染支持更成熟。

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