把字体塞进 PPTX：一次 OpenXML 实战

本文由 AI 基于工程实践创作

1. 引子：为什么”字体嵌入”是个问题

你生成了一份 PPTX，本机用 Inter 字体打开很完美。发给客户，他打开后字体变成宋体或 Arial——视觉差异巨大，标题对齐错乱，emoji 变成方框。

原因：PowerPoint 渲染时只能用”对方系统已安装”的字体，找不到就 fallback 到默认字体。

解决方法：把字体文件本身塞进 .pptx 文件里，让对方 PowerPoint 用包内的字体渲染，不依赖系统安装。这件事叫字体嵌入（font embedding）。

听起来是个小功能，但开源生态对它的支持普遍很差。横向对比一下：

• Word（DOCX）：微软官方的 .NET OpenXML SDK 提供 EmbeddedFontPart 这类封装，能直接添加字体 part；如果你能容忍 Windows + Word 程序本身，也可以用 COM 自动化（ActiveDocument.EmbedTrueTypeFonts = True）让 Word 自己处理。但纯 Python 这边的 python-docx 同样不支持字体嵌入
• PDF：pdfTeX、ReportLab、各种 PDF 库基本默认嵌入字体，几乎不用操心
• PowerPoint（PPTX）：python-pptx 没有任何字体嵌入 API，Aspose.Slides 是商业方案。开源 Python 方案基本只能自己动手

所以 PPTX 字体嵌入这件事，在 Python 服务端场景里”自己动手”几乎是唯一选择。

自己动手意味着下沉到 OpenXML 层——直接修改 .pptx 的 ZIP 结构和里面的 XML。这件事并不复杂，但有不少非显然的约束，踩坑会让你怀疑人生。

本文范围：已经有一份合法的 .fntdata 字体文件后，怎么把它正确塞进 PPTX。本文不讲怎么从 TTF/OTF 制作 .fntdata——这是另一个独立的、棘手的问题，§4.3 会简短交代获取途径。

---

2. PPTX 是什么：一个 ZIP 包里的 XML 集合

在动手前先看看我们要操作的目标是什么。

PPTX 不是单一二进制格式，而是 OpenXML 标准的 ZIP 包。把任何 .pptx 文件后缀改成 .zip 解压，会看到一棵目录树：

my-presentation.pptx (ZIP)
├── [Content_Types].xml          # 全局清单：扩展名 → MIME type
├── _rels/
│   └── .rels                    # 包级关系：谁是入口
├── ppt/
│   ├── presentation.xml         # 演示文稿核心：slide 列表、字体声明等
│   ├── _rels/
│   │   └── presentation.xml.rels  # presentation 引用的所有外部资源
│   ├── slides/
│   │   ├── slide1.xml
│   │   └── ...
│   ├── theme/
│   │   └── theme1.xml
│   └── media/
│       ├── image1.png
│       └── ...

每个 .xml 是一个独立的 part，每个 part 必须遵循自己的 schema。OpenXML 的核心抽象是三件套：

• Part：物理文件（XML 或二进制资源）
• Relationship：part 之间的逻辑引用，由 *.rels 文件描述
• Content Type：每个 part 的 MIME 类型，由全局 [Content_Types].xml 注册

任何外部资源——字体、图片、嵌入对象——都通过 Relationship 机制引用，由全局 Content Types 注册类型。这是 OpenXML 的核心机制，DOCX/XLSX 完全相同。掌握这三件套，你能修改 PPTX/DOCX/XLSX 的几乎任何方面。

嵌入字体涉及修改其中 3 个 XML 文件 + 添加新 part。本文用 Python 演示，但所有操作都直接对应 OpenXML 的通用约定——换 Java（Apache POI）、C#（OpenXML SDK）、Go（unioffice）写法不同但语义 1:1 对应。

3. 嵌入字体的全景：5 步要做的事

在陷入细节之前，先摆出全景。整件事分 5 步：

步骤	改什么	为什么
1. 开总开关	presentation.xml 根节点	告诉 PowerPoint “这个文件启用字体嵌入”，不开等于嵌了也没用
2. 注册扩展名类型	[Content_Types].xml	OpenXML 强制要求：任何 part 的扩展名必须在全局清单里
3. 写入字体二进制	新增 ppt/fonts/font{N}.fntdata	字体文件本体
4. 加关系	presentation.xml.rels	OpenXML 资源引用机制：presentation 通过 rId 引用字体 part
5. 加字体声明	presentation.xml 的 <embeddedFontLst>	把”字体名”和”字体 rId”绑起来，4 个变体（regular/bold/italic/boldItalic）各占一条

后面 §4-§6 按这个顺序逐个展开。§7 把所有步骤拼回完整伪代码。

---

4. Step 1+2：开总开关 + 注册 .fntdata 类型

4.1 开总开关

在 presentation.xml 根节点设两个属性：

root.set("embedTrueTypeFonts", "1")
# 主动删除 saveSubsetFonts，强制全字符集嵌入
if "saveSubsetFonts" in root.attrib:
    del root.attrib["saveSubsetFonts"]

embedTrueTypeFonts="1" 是字体嵌入的总开关。属性名带 “TrueType” 是 OpenXML 历史遗留——即便你嵌的是 OpenType (OTF) 或后面会讲的 EOT 容器，属性名也不变。

saveSubsetFonts 容易被误解：它控制的是 PowerPoint 后续保存时是否把嵌入字体瘦身，而不是我们当前嵌入了多少字符——后者完全由 .fntdata 字节本身决定。

主动删掉这个属性，等于告诉 PowerPoint：用户后续编辑保存时，保留原始嵌入的全部字符，不要自动瘦身。这是为了用户后续编辑时新打的字符仍有字形可用。如果你的场景是只读分发，可以反过来设 saveSubsetFonts="1"——但这只影响用户保存后的文件大小，当下 PPTX 要瘦身得在上游 .fntdata 制作时做。

4.2 注册 .fntdata content type

OpenXML 强制要求：每个 part 的扩展名必须在 [Content_Types].xml 注册一个 MIME 类型，否则 PowerPoint 拒绝打开（报”文件已损坏”）。

字体 part 用 .fntdata 扩展名，MIME 类型是 application/x-fontdata：

default_element = etree.Element(
    "Default",
    Extension="fntdata",
    ContentType="application/x-fontdata"
)
content_types_root.append(default_element)

注册一次就够，后续所有字体文件复用这一条 Default 声明。

这里有个非常关键、容易误导人的事实必须挑明：.fntdata 不是 OpenXML（ECMA-376）规范定义的标准格式，是 PowerPoint 自己的私有约定。

ECMA-376 规范里的字体嵌入用的是另一套：

维度	ECMA-376 规范（DOCX 实际用）	PPTX 实际用
Content Type	application/vnd.openxmlformats-officedocument.obfuscatedFont	application/x-fontdata
文件扩展名	（无硬性要求，常见用 GUID）	.fntdata
文件格式	裸 TTF/OTF + GUID-XOR 混淆（XPS odttf 同款方案）	EOT 容器（W3C EOT 提交格式）

Word 和 PowerPoint 字体嵌入不是同一套机制。这是个”事实标准 vs 规范标准”的典型——规范说一套、PowerPoint 实际另一套。互操作时必须按 PowerPoint 实际行为来，不能按规范推。

验证一下：如果你手头有合法的 .fntdata 文件，跑 file regular.fntdata，会看到：

regular.fntdata: Embedded OpenType (EOT), Inter family

xxd 看头部能找到 EOT magic number 0x504C（小端存储，字节序是 4c 50）：

00000000: ac5d 0000 d45c 0000 0200 0200 0400 0000  .]...\..........
00000010: 0000 0000 0000 0000 0000 0000 9001 0000  ................
00000020: 0000 4c50 ff08 00a0 4b20 0040 0000 0000  ..LP....K .@....
                ^^^^ EOT magic number

这印证了 .fntdata 实际是 EOT 容器。

4.3 题外话：.fntdata 文件从哪来

你可能会问：那直接把 .ttf 或 .otf 改名为 .fntdata 行不行？

不行。PowerPoint 期望的是 EOT 容器（带 PANOSE、charset、weight、fsType 等 header 字段），裸 TTF/OTF 没有 EOT header，PowerPoint 拒绝打开或字体不生效。

直接把 web 用 .eot 文件改名为 .fntdata 行不行？未必。Web 用 EOT 通常带 RootString（域名锁，限制只在某个域名下使用）、fsType 限制嵌入、字段格式可能和 PowerPoint 期望的不一致。

更扎心的事实：微软没有公开 TTF → .fntdata 的转换工具或文档。这是个典型的”实际格式被广泛使用，但转换路径靠逆向”的状态。

实操中拿到 .fntdata 的几种途径，按工程友好度排序：

1. 手动 + 一次性：在 PowerPoint 里手动操作 文件 → 选项 → 保存 → 在文件中嵌入字体，保存一份带嵌入字体的 .pptx，然后把它当 ZIP 解压，从 ppt/fonts/ 里把 .fntdata 文件抠出来。这是最可靠的方式——文件由 PowerPoint 自己产出，格式 100% 兼容。适合字体集合不大、一次性准备的场景。

2. 批量自动化（Windows）：通过 PowerPoint COM 接口用脚本批量处理。在 Windows 机器（或 CI 上的 Windows runner）跑：

   import win32com.client
   
   ppt = win32com.client.Dispatch("PowerPoint.Application")
   pres = ppt.Presentations.Open("/path/to/template.pptx")
   # 关键：开启字体嵌入后另存
   pres.SaveAs("/path/to/output.pptx",
              FileFormat=24,                  # ppSaveAsOpenXMLPresentation
              EmbedTrueTypeFonts=True)
   pres.Close()
   # 然后把 output.pptx 当 zip 解压、抠 .fntdata
   

   能做到字体仓库 CI 自动化更新，但要求一台装了 PowerPoint 的 Windows 机器（一次性投入但能省后续手工成本）。

3. 逆向自己造 EOT：参考 W3C EOT submission 自己写 EOT header 拼装 TTF/OTF 数据，处理 fsType、可选的 XOR 混淆。能跑通但脆弱——某些 PowerPoint 版本对 header 字段宽容度不一。除非你在做字体相关的开源工具，不建议走这条。

4. 商用工具兜底：Aspose.Slides 之类的商业 SDK 内置转换。预算允许且不想踩坑选这条。

本文范围严守在”已经有 .fntdata 后怎么用”。如何制作 .fntdata 是另一篇文章的事。

---

5. Step 3+4：写字体文件 + 加关系

5.1 字体文件命名与路径

命名约定：ppt/fonts/font{N}.fntdata，N 从 1 自增。多个字体文件平铺在 ppt/fonts/ 目录下，不分子目录。

这个 N 和后面 rId 的数字没关系——它们是两套独立计数。font1.fntdata 不一定对应 rId1。

font_counter += 1
font_filename = f"font{font_counter}.fntdata"
font_part_name = f"ppt/fonts/{font_filename}"
write_part(font_part_name, font_bytes)

5.2 ZIP 修改的”内存暂存 + 一次性写出”模式

这里讲一个落地时绕不开的坑：ZIP 文件不支持原地修改 entry。你不能”打开 zip → 改一个文件 → 关闭”。

所有 ZIP 库（Python zipfile、Java java.util.zip、Go archive/zip、C# System.IO.Compression）都是这样的。这不是某个库的限制，是 ZIP 格式本身的设计——entry 头部里有偏移量、CRC、压缩长度等字段，改一个 entry 就要重写整个 central directory，库统一不支持原地改。

通用模式是：

def save_modified_zip(original_zip, modifications, new_path):
    with zipfile.ZipFile(new_path, "w", zipfile.ZIP_DEFLATED) as new_zip:
        # 1. 复制未修改的 part
        for part_name in original_zip.namelist():
            if part_name in modifications:
                new_zip.writestr(part_name, modifications[part_name])
            else:
                new_zip.writestr(part_name, original_zip.read(part_name))
        # 2. 写新增 part（原 zip 里没有的）
        for part_name, content in modifications.items():
            if part_name not in original_zip.namelist():
                new_zip.writestr(part_name, content)

把这段封装成一个 PPTXPackage 类——所有修改先暂存在内存 dict，最后 save() 时一次性写新 zip——后续所有对 OpenXML 文件的修改都能复用这个基础设施。这是处理 PPTX/DOCX/XLSX 这类 OpenXML 文件的通用模式，不是字体嵌入特有。

5.3 加 Relationship

OpenXML 的资源引用是间接的：presentation.xml 不直接写”我引用 ppt/fonts/font1.fntdata”，而是写”我引用 rId5″，presentation.xml.rels 里查 rId5 → fonts/font1.fntdata，再相对解析路径。

<!-- presentation.xml.rels -->
<Relationships>
  <Relationship Id="rId5"
                Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/font"
                Target="fonts/font1.fntdata"/>
</Relationships>

几个细节：

路径是相对的。presentation.xml.rels 在 ppt/_rels/ 下，target fonts/font1.fntdata 相对的是引用方 presentation.xml 所在目录（ppt/），所以最终指向 ppt/fonts/font1.fntdata。这是 OpenXML 的相对路径解析规则。

Relationship type 是个标准 URI：http://schemas.openxmlformats.org/officeDocument/2006/relationships/font，这是 OpenXML spec 规定的字体关系类型。任何 OpenXML 库都用这个值，不能自己编。

rId 自增策略：扫现有所有 rId 找最大数字 + 1，不复用 gap。这是为了避免和文档其他历史版本冲突：

def get_next_rid(rels_root):
    max_id = 0
    for rel in rels_root.findall("*"):
        rid = rel.get("Id")  # "rId5"
        if rid and rid.startswith("rId"):
            num = int(rid[3:])
            max_id = max(max_id, num)
    return f"rId{max_id + 1}"

---

6. Step 5：embeddedFontLst 字体声明

最后一步：在 presentation.xml 里加字体声明，把”字体名”和”字体 rId”绑起来。

6.1 整体结构

presentation.xml 里加 <p:embeddedFontLst> 块，里面每个 <p:embeddedFont> 声明一个字体家族。一个家族最多 4 个变体：regular / bold / italic / boldItalic。每个变体引用一个 rId：

<p:embeddedFontLst>
  <p:embeddedFont>
    <p:font typeface="Inter" pitchFamily="2" charset="0"/>
    <p:regular r:id="rId5"/>
    <p:bold r:id="rId6"/>
    <p:italic r:id="rId7"/>
    <p:boldItalic r:id="rId8"/>
  </p:embeddedFont>
  <p:embeddedFont>
    <p:font typeface="Roboto" pitchFamily="2" charset="0"/>
    <p:regular r:id="rId9"/>
    <p:bold r:id="rId10"/>
  </p:embeddedFont>
</p:embeddedFontLst>

看起来很直白，但这里藏了 4 个非显然的约束，每一个搞错都会让 PowerPoint 报”文件已损坏”。

6.2 约束 1：变体顺序固定

OpenXML schema 要求 4 个变体严格按 regular → bold → italic → boldItalic 顺序排列，不能乱。即便你只嵌入了 bold 和 italic 两个，也只能写 <p:bold> 和 <p:italic>，不能为了”占位整齐”补一个 <p:regular> 或调整顺序。

代码里按固定顺序遍历，缺的变体直接跳过：

variant_order = [
    ("regular",     "regular"),
    ("bold",        "bold"),
    ("italic",      "italic"),
    ("bold_italic", "boldItalic"),
]
for variant_name, xml_variant_name in variant_order:
    if variant_name in variant_rids:
        rid = variant_rids[variant_name]
        variant_el = etree.SubElement(
            embedded_font_el,
            etree.QName(ns["p"], xml_variant_name)
        )
        variant_el.set(etree.QName(ns["r"], "id"), rid)

6.3 约束 2：embeddedFontLst 的位置

<embeddedFontLst> 必须放在 <defaultTextStyle> 之前。PPTX schema 对 <presentation> 的子元素顺序敏感，放错位置 PowerPoint 报错。

font_list_el = etree.Element(etree.QName(ns["p"], "embeddedFontLst"))

default_text_style = root.find("p:defaultTextStyle", ns)
if default_text_style is not None:
    # 插到 defaultTextStyle 前面
    root.insert(list(root).index(default_text_style), font_list_el)
else:
    # 没有就追加到最后
    root.append(font_list_el)

更完整的子元素顺序：sldMasterIdLst → notesMasterIdLst → handoutMasterIdLst → sldIdLst → sldSz → notesSz → embeddedFontLst → custShowLst → photoAlbum → custDataLst → kinsoku → defaultTextStyle → modifyVerifier → extLst。落地时只用关心 embeddedFontLst 在 defaultTextStyle 之前就够。

6.4 约束 3：pitchFamily 和 charset

<p:font> 元素必须有 pitchFamily 和 charset 两个属性。直接固定写 pitchFamily="2" charset="0" 即可：

• pitchFamily="2" 表示”可变宽字体”（Variable）
• charset="0" 表示”默认字符集”（ANSI/系统默认）

这俩是 GDI 时代（Windows 早期字体描述符）的遗留。现代 PowerPoint 基本不用它们做实质决策，但 schema 要求必须有，老版本 PowerPoint 的兼容性也依赖它们。固定写 2 和 0 对绝大多数场景够用。

6.5 约束 4：typeface 必须严格匹配

如果文档里某段文字用 <a:rFont typeface="Inter"/>，这里 <p:font typeface="Inter"/> 必须完全一致——大小写、空格、连字符全要对得上。Inter ≠ inter ≠ Inter Variable ≠ Inter-Regular。

不一致的话 PowerPoint 找不到嵌入字体，会 fallback 到系统字体，看起来像”字体没嵌成功”，但其实嵌进去了只是名对不上。

调试方法：用 fonttools 查字体的 name table，确认 family name 字段是什么：

ttx -t name regular.ttf  # 输出 XML，找 <namerecord nameID="1"> 即 family name

把这个 name 用作 typeface 属性值，并确保文档里所有引用这个字体的地方都用同样的字符串。

6.6 顺便提的字体嵌入许可

不是所有字体都允许嵌入。字体文件的 OS/2 表里有个 fsType 字段，定义了嵌入许可级别：

fsType	含义
0	Installable Embedding（可任意嵌入 + 编辑，开放）
2	Restricted License（不允许嵌入）
4	Preview & Print（可嵌入，但接收方不能编辑文字）
8	Editable（可嵌入 + 编辑，需符合许可）

PowerPoint 嵌入前会检查这个值。嵌入了 fsType=2 的字体，PowerPoint 可能拒绝、可能接受但提示版权问题。

这件事通常放在上游过滤——准备字体仓库时就按 fsType 筛选，嵌入逻辑本身不做检查。如果你发现某些字体 PowerPoint 拒绝打开，先用 fonttools 查 fsType：

ttx -t OS/2 regular.ttf  # 找 <fsType value="..."/>

---

7. 完整流程组装

把 §4-§6 拼起来。整个字体嵌入逻辑大约 50 行伪代码：

def embed_fonts_into_pptx(pptx_path, font_variants_dict, output_path):
    """
    font_variants_dict = {
        "Inter": {
            "regular":     "/path/to/Inter-Regular.fntdata",
            "bold":        "/path/to/Inter-Bold.fntdata",
            "italic":      "/path/to/Inter-Italic.fntdata",
            "bold_italic": "/path/to/Inter-BoldItalic.fntdata",
        },
        "Roboto": {
            "regular": "/path/to/Roboto-Regular.fntdata",
            "bold":    "/path/to/Roboto-Bold.fntdata",
        },
    }
    """
    pkg = open_pptx_as_zip(pptx_path)

    # Step 1: 开总开关
    pres_root = pkg.get_presentation_root()
    pres_root.set("embedTrueTypeFonts", "1")
    pres_root.attrib.pop("saveSubsetFonts", None)

    # Step 2: 注册 .fntdata content type（一次就够）
    pkg.ensure_content_type_default("fntdata", "application/x-fontdata")

    font_counter = 0
    for font_family, variants in font_variants_dict.items():
        variant_rids = {}

        for variant_name, font_path in variants.items():
            font_counter += 1
            font_filename = f"font{font_counter}.fntdata"

            # Step 3: 写字体二进制
            pkg.write_part(
                f"ppt/fonts/{font_filename}",
                Path(font_path).read_bytes()
            )

            # Step 4: 加 relationship
            rid = pkg.add_relationship(
                FONT_RELATIONSHIP_TYPE,
                f"fonts/{font_filename}"
            )
            variant_rids[variant_name] = rid

        # Step 5: 加字体声明（按 regular/bold/italic/boldItalic 顺序）
        add_embedded_font_declaration(
            pkg, font_family, variant_rids
        )

    pkg.save(output_path)

这就是完整字体嵌入实现。用 lxml 改 XML、用 zipfile 写 ZIP，都是标准库范畴。换 Java（Apache POI）、C#（OpenXML SDK）、Go（unioffice）写完全对应——核心逻辑都在 OpenXML 的 part + relationship + content type 三件套上。

---

8. 常见踩坑速查

落地时遇到问题可以对号入座：

现象	可能原因
PowerPoint 打开报”文件已损坏”	<embeddedFontLst> 放错位置（必须在 <defaultTextStyle> 之前），或子元素顺序错（必须 regular/bold/italic/boldItalic）
文件能打开但字体没生效	typeface 名和文档里实际用的不一致（检查大小写、空格、连字符）。用 fonttools 查字体的 name table 确认
嵌入了 .ttf 改名的 .fntdata，PowerPoint 拒绝打开	.fntdata 必须是真正的 EOT 容器，裸 TTF 不行。从 PowerPoint 自己导出抠取 .fntdata
嵌入了 web 用 EOT，PowerPoint 报字体许可问题或不识别	web EOT 多半带 RootString 域名锁、fsType 限制嵌入、字段格式不符 PowerPoint 期望
文件能打开但 PowerPoint 警告”文件包含字体且许可受限”	嵌入了 fsType=2 的字体。改用开放许可字体或 fsType=0/8 的
文件比预期大很多	上游传入的 .fntdata 本身大（CJK 字体、未子集化）。当下 PPTX 的字体大小完全取决于 .fntdata 字节，saveSubsetFonts 属性管不到这一步——要瘦身要在上游做
[Content_Types].xml 没注册 .fntdata	文件能打开但字体不被识别
多次嵌入字体后 rId 冲突	rId 计数没扫描到所有现有关系。get_next_rid 必须扫整棵 rels 文件
想批量造 .fntdata 但没 Windows 环境	考虑 CI 上的 Windows runner 跑 PowerPoint COM 脚本，或商用 SDK

---

9. 一个可以迁移的判断

这套思路不只属于字体嵌入。任何对 OpenXML 文件的”非标准修改”都遵循同一套机制：

• 嵌入图片 / 视频 / 音频：part + relationship + content type 三件套
• 嵌入图表 / 嵌入的 Excel 表：同上 + 嵌入的 part 自己也是个 OpenXML 包（嵌套）
• 嵌入自定义 XML 数据：同上
• 添加自定义属性 / 元数据：part + content type，可能不需要 relationship

一旦你理解了 PPTX 字体嵌入的 5 步，Word 嵌入图片、Excel 嵌入图表、PPTX 嵌入视频都是同一套套路，只是 part 的目标路径和 Content Type 不同。

但请注意：DOCX 和 PPTX 的字体嵌入不是同一套机制。DOCX 走 ECMA-376 规范的 obfuscatedFont（GUID-XOR 混淆，XPS odttf 同款），PPTX 走私有 .fntdata（EOT 容器）。本文方法只覆盖 PPTX，移植到 DOCX 不能直接套——具体看 ECMA-376 Part 1 §17.8 和 §15.2.13。

OpenXML 的核心抽象就这三个概念：part（物理文件） + relationship（逻辑引用） + content type（类型注册）。掌握这三个，你能修改 PPTX/DOCX/XLSX 的几乎任何方面。

Office 文档不是黑盒，它就是一个有规矩的 ZIP——规矩学会了就完全可控。

---

10. 附录：进一步阅读

• ECMA-376 Office Open XML 规范（免费 PDF，Part 1 §17.8 字体相关章节）
• W3C EOT Submission（2008）（EOT 容器格式参考，做 .fntdata 制作必看）
• python-pptx 文档（高层 PPTX 操作，注意它没字体嵌入 API）
• pywin32 文档（PowerPoint COM 接口的 Python 入口）
• Microsoft Application.PresentationBase.SaveAs 文档（COM 自动化里嵌入字体的关键调用）
• fonttools（查 fsType / name table 的标准工具）

如果你正在动手做 OpenXML 修改方面的事，欢迎在评论里讨论你遇到的边界 case——这个领域的”踩坑地图”比表面看到的要大得多。