如何在JavaFX中渲染带连写字形的波斯语/阿拉伯语文本

问题原因 #

阿拉伯语、波斯语等属于从右到左的连写文字，单个字符的字形会根据其在单词中的位置（词首、词中、词尾、孤立）自动切换对应形态。当你把完整文本拆分成多个独立的Text组件时，每个组件仅包含单个字符，JavaFX无法识别字符之间的连写上下文关系，因此会以孤立形态渲染每个字符，最终导致文本显示断裂。

解决方案 #

方案1：使用单个Text组件的范围样式（推荐） #

如果你的需求只是给部分字符设置不同样式（比如示例中的变色），完全不需要拆分Text组件。JavaFX的Text类支持通过setStyleRange()方法为指定字符范围单独设置样式，既保留完整文本的连写上下文，又能实现局部样式定制。

修改后的代码示例：

public class HelloFX extends Application {

    @Override
    public void start(Stage stage) throws Exception {
        Font font = new Font("Arial", 48);

        String message = "\u0627\u0644\u0633\u0644\u0627\u0645  \u0639\u0644\u064a\u0643\u0645";
        TextFlow textFlow1 = new TextFlow();
        Text text1 = new Text(message);
        text1.setFont(font);
        textFlow1.getChildren().addAll(text1);

        // 使用单个Text+范围样式替代拆分组件
        TextFlow textFlow2 = new TextFlow();
        Text text2 = new Text(message);
        text2.setFont(font);
        // 为偶数索引的字符设置红色
        for (int i = 0; i < message.length(); i++) {
            if (i % 2 == 0) {
                text2.setStyleRange(i, 1, "-fx-fill: red;");
            }
        }
        textFlow2.getChildren().add(text2);

        VBox box = new VBox(textFlow1, textFlow2);
        box.setNodeOrientation(NodeOrientation.RIGHT_TO_LEFT);
        Scene scene = new Scene(box, 400, 150);
        stage.setScene(scene);
        stage.show();
    }
}

方案2：必须拆分组件时的处理（不推荐） #

如果业务场景确实需要拆分文本为多个Text组件，你需要确保每个Text组件包含足够的上下文字符，让JavaFX能正确识别连写形态。比如不要仅拆分单个字符，而是按单词或连写单元拆分，或者手动插入连写控制字符，但这种方式复杂度高、易出错，仅适用于特殊场景。

验证说明 #

上述方案在JavaFX 18.0.1、Java 17环境下，Mac OS和Linux系统均能正常显示连写的阿拉伯/波斯语文本，同时满足局部样式需求。

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