Apache FOP.NetCore 3.0无法识别Wingdings 2/3字体问题咨询

1. 确认字体的真实内部名称 #

Windows系统中字体的显示名称（比如“Wingdings 2”）和字体文件的内部名称可能不一致，这是FOP无法识别的常见原因。用PowerShell执行以下命令查看Wingdings系列字体的真实文件名称：

Get-ItemProperty "HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Fonts" | Where-Object { $_.PSChildName -like "*Wingdings*" }

输出结果中，类似Wingdings 2 (TrueType)对应的属性值就是字体文件的真实名称（通常是wingding2.ttf）。若要确认字体的内部名称，可使用FontForge等工具打开TTF文件查看，Wingdings 2的内部名称一般为Wingdings2。

2. 显式配置FOP字体映射 #

FOP默认不会自动加载所有系统字体，需要通过配置文件显式指定字体路径和映射关系：

1. 创建fop.xconf配置文件，内容如下：

<fop version="1.0">
  <renderers>
    <renderer mime="application/pdf">
      <fonts>
        <!-- 配置Wingdings 2 -->
        <font kerning="yes" embed-url="C:/Windows/Fonts/wingding2.ttf">
          <font-triplet name="Wingdings2" style="normal" weight="normal"/>
        </font>
        <!-- 配置Wingdings 3 -->
        <font kerning="yes" embed-url="C:/Windows/Fonts/wingding3.ttf">
          <font-triplet name="Wingdings3" style="normal" weight="normal"/>
        </font>
      </fonts>
    </renderer>
  </renderers>
</fop>

2. 在C#代码中加载该配置文件初始化FOP：

using org.apache.fop;
using org.apache.fop.apps;
using java.io;

// 读取配置文件
var configStream = new FileInputStream("fop.xconf");
var fopConfig = FopConfigParser.parse(configStream);
configStream.close();

// 初始化FOP并生成PDF
var outputStream = new FileOutputStream("output.pdf");
var fop = new Fop(MimeConstants.MIME_PDF, fopConfig, outputStream);

3. 在XSL-FO中正确引用字体 #

确保XSL-FO中的font-family值和配置文件里font-triplet的name属性完全一致：

<fo:block font-family="Wingdings2">这里是Wingdings 2的目标字符</fo:block>
<fo:block font-family="Wingdings3">这里是Wingdings 3的目标字符</fo:block>

4. 验证字体嵌入与权限 #

• 生成PDF后，查看PDF属性中的字体列表，确认Wingdings2/3已被成功嵌入。
• 检查FOP运行进程是否有读取C:/Windows/Fonts目录下字体文件的权限，若权限不足，可复制字体文件到项目目录并修改配置中的embed-url路径。

5. 确认字符编码正确性 #

Wingdings系列字体的字符映射与标准Unicode不同，建议通过Windows自带的“字符映射表”工具复制目标字符到XSL-FO中，避免手动输入错误编码导致显示异常。

内容的提问来源于stack exchange，提问作者Bunkai.Satori