macOS下JavaFX中表情符号后的文本无法渲染，求解决方案

我创建了一个简单的JavaFX应用，代码如下：

public class App extends Application
{
    public static void main( String[] args )
    {
        launch( args );
    }
    
    @Override
    public void start( Stage primaryStage )
    {
        TextFlow textFlow = new TextFlow();
        Text text1 = new Text( "\uD83D\uDE00" + " " + "foo" + "\n" );
        Text text2 = new Text( "\uD83D\uDE01" + " " + "bar" + "\n" );
        Text text3 = new Text( "\uD83D\uDE02" + " " + "baz" + "\n" );
        textFlow.getChildren().addAll( text1, text2, text3 );
        VBox vbox = new VBox( textFlow );
        Scene scene = new Scene( vbox, 300, 200 );
        primaryStage.setScene( scene );
        primaryStage.show();
    }
}

在macOS上运行时，仅第一个Text节点显示正常，其余两个节点只显示表情符号，后续文本完全不显示。更换字体、替换VBox为其他容器都无法解决；移除表情符号后所有文本都能正常显示。该应用在Windows 10上运行完全正常。

我正在开发一个需要显示大量含表情符号文本的大型应用，这个问题导致文本流中出现大量空白，急需解决方案。

我的开发环境：

• 操作系统：macOS 15.2
• 处理器：Apple M4
• javafx-controls版本：23.0.1
• controlsfx版本：11.2.1
• JDK：OpenJDK Runtime Environment Corretto-21.0.5.11.1（build 21.0.5+11-LTS）

解决方案尝试 #

1. 拆分表情符号与普通文本为独立Text节点 #

将每个混合了表情和普通文本的Text节点拆分为两个独立节点，避免单个节点内同时包含表情符号（双Unicode码点）和普通字符：

@Override
public void start( Stage primaryStage )
{
    TextFlow textFlow = new TextFlow();
    
    // 拆分每个条目为表情和文本
    Text emoji1 = new Text("\uD83D\uDE00" + " ");
    Text content1 = new Text("foo\n");
    
    Text emoji2 = new Text("\uD83D\uDE01" + " ");
    Text content2 = new Text("bar\n");
    
    Text emoji3 = new Text("\uD83D\uDE02" + " ");
    Text content3 = new Text("baz\n");
    
    textFlow.getChildren().addAll(emoji1, content1, emoji2, content2, emoji3, content3);
    
    VBox vbox = new VBox( textFlow );
    Scene scene = new Scene( vbox, 300, 200 );
    primaryStage.setScene( scene );
    primaryStage.show();
}

2. 显式指定字体并分离表情与文本的字体 #

macOS上的表情符号依赖Apple Color Emoji字体，而普通文本可以使用系统默认的无衬线字体，分别给表情和文本节点设置对应字体：

Font emojiFont = Font.font("Apple Color Emoji", 14);
Font textFont = Font.font("SF Pro Text", 14);

emoji1.setFont(emojiFont);
content1.setFont(textFont);
// 其他节点同理

3. 升级JavaFX版本到最新稳定版 #

这个问题大概率是JavaFX在Apple Silicon平台上的渲染bug，尝试升级到JavaFX 23.0.2或更高版本，官方可能已修复此类布局计算错误。

4. 移除Text节点内的换行符，改用独立换行节点 #

避免将\n合并到单个Text节点中，改用单独的Text("\n")节点实现换行：

textFlow.getChildren().addAll(emoji1, content1, new Text("\n"), emoji2, content2, new Text("\n"), emoji3, content3);

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