XSL-FO是W3C制定的XML页面布局规范，用于将XML数据精确排版为PDF等固定格式；它不渲染，需经FO处理器（如Apache FOP）转换，流程为XML→XSLT→.fo→PDF，并需配置中文字体支持。
XSL-FO（Extensible Stylesheet Language - Formatting Objects）不是一种编程语言，而是一套基于 XML 的**页面布局描述规范**，由 W3C 制定，专用于把结构化数据（通常是 XML）精确排版成可打印、高保真的固定格式文档，比如 PDF、PostScript 或 AFP。
XSL-FO 的核心定位
它不直接处理逻辑或交互，只专注“怎么印出来”：页边距、分栏、页眉页脚、字体嵌入、表格对齐、断行避头尾、跨页表格保持完整……这些印刷级控制能力，是 HTML/CSS 在 PDF 生成中难以稳定实现的。
关键点在于：XSL-FO 本身不渲染，它只是中间描述文件（.fo），必须交由 FO 处理器（如 Apache FOP）翻译成 PDF。
生成 PDF 的标准两步流程
实际使用中，你几乎总是走这个链路：
- 用 XSLT 把原始 XML 数据（如订单、报表、发票）转换成符合 XSL-FO 语法的 .fo 文件
- 用 FO 处理器（例如 Apache FOP）读取 .fo，输出 PDF
整个过程清晰分离：XML 是数据，XSLT 是转换规则，XSL-FO 是排版蓝图，FOP 是印刷厂。
一个最小可用的 .fo 文件长什么样
下面这段代码保存为 hello.fo，就能直接用 FOP 生成 PDF：
<?xml version="1.0" encoding="UTF-8"?>
<fo:root xmlns:fo="http://www.w3.org/1999/XSL/Format">
<fo:layout-master-set>
<fo:simple-page-master master-name="A4" page-width="210mm" page-height="297mm" margin="20mm">
<fo:region-body/>
</fo:simple-page-master>
</fo:layout-master-set>
<fo:page-sequence master-reference="A4">
<fo:flow flow-name="xsl-region-body">
<fo:block font-size="16pt" font-weight="bold" text-align="center">Hello, PDF!</fo:block>
<fo:block font-size="12pt" margin-top="12pt">这是用 XSL-FO 生成的第一页。</fo:block>
</fo:flow>
</fo:page-sequence>
</fo:root>注意几个必需元素：<fo:root> 是根，<fo:layout-master-set> 定义纸张和区域（body / before / after），<fo:page-sequence> 绑定模板并组织内容流。
中文支持与字体配置（最容易卡住的一步）
Apache FOP 默认不带中文字体，直接跑上面的 .fo 会丢字或显示方块。解决方法很明确：
- 下载一个 TrueType 中文字体（如 Noto Sans CJK SC、思源黑体、微软雅黑）
- 在 FOP 配置文件 fop.xconf 的
<fonts>节点下添加字体目录或具体字体路径 - 在 .fo 文件里显式指定
font-family="Noto Sans CJK SC"（名称必须和配置中完全一致）
配置示例片段：
<renderer mime="application/pdf">
<fonts>
<directory>./fonts</directory>
<font embed-url="fonts/NotoSansCJKsc-Regular.otf">
<font-triplet name="Noto Sans CJK SC" style="normal" weight="normal"/>
</font>
</fonts>
</renderer>基本上就这些。不需要学新语法体系，只要理解“XML → XSLT → FO → PDF”这条链，掌握 layout-master、region-body、block、inline 这几个核心标签，再搞定中文字体，就能稳定产出专业 PDF。
