在ReportLab表单TextField中使用自定义字体报错，求问题排查

问题分析 #

你遇到的错误核心原因是：PDF表单（AcroForms）对自定义字体的要求和普通文档文本不同——仅通过pdfmetrics.registerFont注册字体不足以让表单字段识别它，必须确保字体被嵌入到PDF中，同时你的代码里还有个低级拼写错误：Calibri.tff应该是Calibri.ttf（字体文件后缀为两个t），这也可能导致字体注册失败。

正确操作步骤 #

1. 修正字体文件名拼写 #

首先把代码里的Calibri.tff改为Calibri.ttf，确保能正确加载字体文件。如果字体不在当前工作目录，要使用绝对路径，比如C:/Windows/Fonts/Calibri.ttf（Windows系统）或/Library/Fonts/Calibri.ttf（Mac系统）。

2. 表单字段使用自定义字体的正确流程 #

以你使用的ReportLab库为例，除了注册字体，还需要在创建TextField时明确指定字体，同时确保PDF生成过程中字体被嵌入。以下是完整的示例代码：

from reportlab.pdfgen import canvas
from reportlab.pdfbase import pdfmetrics
from reportlab.pdfbase.ttfonts import TTFont
from reportlab.lib.colors import white, black

# 注册Calibri字体，注意文件路径和后缀
pdfmetrics.registerFont(TTFont('Calibri', 'Calibri.ttf'))

# 创建PDF画布
c = canvas.Canvas("custom_font_form.pdf")

# 先绘制一段普通文本验证字体是否注册成功（可选测试步骤）
c.setFont('Calibri', 14)
c.drawString(50, 750, "Calibri字体测试文本")

# 创建TextField并指定Calibri字体
c.acroForm.textfield(
    name='customField',
    x=50, y=700,
    width=300, height=30,
    fontName='Calibri',  # 这里要和注册的字体名一致
    fontSize=12,
    fillColor=white,
    borderColor=black,
    textColor=black
)

# 保存PDF
c.save()

3. 额外注意事项 #

• 字体版权：Calibri属于微软的字体，要确认其许可协议允许嵌入到PDF中，避免版权问题。
• 字体嵌入验证：生成PDF后，可以用Adobe Acrobat打开，查看表单字段的字体属性，确认Calibri已被嵌入。
• 版本兼容性：如果使用的是较旧版本的ReportLab，可能存在表单字体支持的bug，建议升级到最新稳定版。

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