JavaFX打印及导出PDF时自定义字体未生效如何解决

这是JavaFX打印管线的固有逻辑限制，和macOS打印流程无关，在Windows、Linux平台下复现逻辑完全一致：

• 屏幕渲染阶段，JavaFX的Prism渲染引擎可以直接识别CSS中@font-face声明的、打包在应用内的私有字体资源，因此界面显示完全正常
• 打印阶段，JavaFX不会自动将CSS加载的私有字体传递给原生打印后端，后端只会检索系统全局安装的字体，找不到匹配字体时就自动回退到系统默认无衬线字体
• 修改字号能在打印结果中生效，是因为字号属于布局属性，不依赖字体文件本身的加载；导出PDF大小无变化也对应这个逻辑——后端根本没有读取到你打包的TTF文件，自然不会把字体子集嵌入PDF。

按推荐优先级排序：

• 提前在代码中全局注册自定义字体
  不要仅依赖CSS的@font-face声明加载字体，在应用启动阶段、执行打印逻辑前，手动通过JavaFX的Font类加载字体到全局上下文，打印管线就能正常识别到该字体，原有CSS配置不需要修改。
  加载代码示例：

  // 注意路径填写类路径下的字体绝对路径，不要用相对路径
  Font.loadFont(getClass().getResourceAsStream("/fonts/PTSerif-Regular.ttf"), 12);
  

  这里传入的字号参数不影响后续CSS的字号配置，只是加载时的初始化参数，最终排版会以CSS里的font-size规则为准。

• 打印前递归给节点手动绑定字体对象
  如果全局注册后打印仍有字体回退问题，可以在拿到待打印的Pane节点后，递归遍历节点下所有带字体属性的控件，手动给控件setFont绑定加载好的自定义字体，完全绕开CSS字体匹配逻辑。
  递归方法示例：

  private void setCustomFontForAllNodes(Node node, Font customFont) {
      if (node instanceof Text) {
          ((Text) node).setFont(customFont);
      } else if (node instanceof Labeled) {
          ((Labeled) node).setFont(customFont);
      } else if (node instanceof TextInputControl) {
          ((TextInputControl) node).setFont(customFont);
      }
      // 递归处理子节点
      if (node instanceof Parent) {
          for (Node child : ((Parent) node).getChildrenUnmodifiable()) {
              setCustomFontForAllNodes(child, customFont);
          }
      }
  }
  

  在打印逻辑中调用即可：

  Pane pane = getView(pageLayout.getPrintableWidth(), pageLayout.getPrintableHeight());
  pane.getStylesheets().add(getRootCSSURLString());
  // 新增这两行
  Font ptSerif = Font.loadFont(getClass().getResourceAsStream("/fonts/PTSerif-Regular.ttf"), 12);
  setCustomFontForAllNodes(pane, ptSerif);
  
  boolean success = job.printPage(pageLayout, pane);
  

• 位图兜底方案
  如果前两种方案都不生效，可以先把待打印的Pane渲染为图片快照，再把图片传入打印任务。这种方式可以保证打印效果和屏幕显示100%一致，缺点是输出内容为位图，文字边缘在高DPI打印下可能略虚，导出的PDF也无法选中文字内容。

• 原有CSS里的@font-face配置不需要删除，屏幕端的界面渲染仍然依赖该配置，代码中手动加载字体只是补全打印管线的字体注册逻辑，两者不会冲突
• 加载字体时必须用类路径方式读取资源，不要用文件相对路径，打印时的进程工作路径可能和应用运行路径不一致，容易出现资源找不到的问题

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