MAUI中通过静态类引用FontAwesome图标字形渲染异常

问题描述 #

在MAUI项目中使用FontAwesome5时，直接在XAML中用字面量引用图标字形（如）能正常显示图标，但通过自定义静态类引用该字形时，图标未渲染，反而显示原始字符串。

正确渲染的代码示例 #

<Image Grid.Column="1" WidthRequest="40" HeightRequest="40" Margin="5,5,10,5" VerticalOptions="Center">
  <Image.Source>
    <FontImageSource FontFamily="{x:Static font:FontAwesome.Duotone}" Glyph="&#xf064;" />
  </Image.Source>
</Image>

异常代码示例 #

<Image Grid.Column="1" WidthRequest="40" HeightRequest="40" Margin="5,5,10,5" VerticalOptions="Center">
  <Image.Source>
    <FontImageSource FontFamily="{x:Static font:FontAwesome.Duotone}" Glyph="{x:Static font:FontAwesome.Share}" />
  </Image.Source>
</Image>

静态类定义（原异常版本） #

[XamlCompilation(XamlCompilationOptions.Compile)]
public static class FontAwesome
{
  // ...
  public static string Share = "";
  // ...
}

问题原因 #

XAML编译器处理字面量时，会自动将这类XML实体编码解码为对应的Unicode字符；但通过{x:Static}引用静态类字段时，编译器不会做解码操作，直接把字符串""传递给Glyph属性，导致显示的是编码文本而非图标。

解决办法 #

将静态类中的字形值改为直接使用Unicode转义字符，而非XML实体编码：

修改后的静态类代码：

[XamlCompilation(XamlCompilationOptions.Compile)]
public static class FontAwesome
{
  // ...
  // 用C# Unicode转义格式，对应原XML实体
  public static string Share = "\uf064";
  // ...
}

如果编辑器支持直接输入图标字符，也可以直接写字符本身（效果一致）：

public static string Share = "🔗"; // 对应f064的图标，需匹配实际图标

修改完成后，XAML中通过{x:Static font:FontAwesome.Share}引用就能正常渲染图标了。

补充提示 #

• 可以通过FontAwesome官方图标库查询每个图标的Unicode值（格式为U+XXXX），在C#中只需将U+替换为\u即可使用。
• 所有通过代码传递给FontImageSource.Glyph的内容，都必须是解码后的Unicode字符，不能是XML实体编码。

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