使用Python fpdf2生成PDF时如何配置字体显示WhatsApp字符与图标

• 你当前的字体加载逻辑本身有错误：add_font传入的字体别名是DejaVuSans，但实际加载的文件是segoe-ui-symbol.ttf，别名与实际字库不匹配会直接导致渲染异常。
• Segoe UI Symbol是微软早年推出的旧版符号字库，字符覆盖范围极旧：既不包含新版Unicode收录的emoji（比如你提到的🍀），也没有完整覆盖拉丁扩展字符集，无法正确渲染â这类带变音符号的字符。
• 不存在公开可下载的WhatsApp官方专属TTF字体：WhatsApp界面内的普通文本调用的是运行设备的系统默认字体，功能图标属于内置矢量资源，并不在字体文件的字符映射表里，不需要专门寻找WhatsApp专属字体。

1. 选用匹配需求的字库 #

你需要准备两类TTF格式字库，不要用彩色字体、woff/ttc格式字库，fpdf2对这类格式兼容性很差：

• 常规文本类字库：选择覆盖完整拉丁扩展字符集的无衬线字体即可，比如Noto Sans、DejaVu Sans，这类字库可以完美渲染普通文本、带变音符号的特殊字符。
• 符号/emoji类字库：选择单色TTF版本的Noto Emoji，这类字库覆盖了所有通用Unicode emoji、通用通讯类符号，可以满足WhatsApp相关标识、表情的渲染需求。

2. 正确配置fpdf2的字体加载与回退 #

利用fpdf2自带的字体回退机制，常规字符用文本字库渲染，遇到字库不存在的emoji/符号时，自动调用emoji字库渲染，参考代码如下：

from fpdf import FPDF

pdf = FPDF()
pdf.add_page()

# 加载常规文本字体，别名与字体用途对应即可
pdf.add_font("NotoSans", fname="your_local_path/NotoSans-Regular.ttf")
# 加载emoji字体，作为回退字库
pdf.add_font("NotoEmoji", fname="your_local_path/NotoEmoji-Regular.ttf")

# 设置全局正文字体
pdf.set_font("NotoSans", size=12)
# 指定回退字体列表，按顺序匹配
pdf.set_fallback_fonts(["NotoEmoji"])

# 写入测试内容，包含变音字符、emoji、通讯类符号
pdf.multi_cell(0, 10, text="Test â character 🍀 WhatsApp message 💬 test")
pdf.output("whatsapp_content.pdf")

• add_font的第一个参数是自定义字体别名，后续set_font调用时必须和这个别名完全一致，不要出现别名和实际加载文件错配的问题。
• 不要使用Windows自带的Segoe UI Emoji字库，该字库为彩色COLR格式，fpdf2加载后会出现字符错位、缺块问题。
• 如果出现类似’的组合乱码，先检查Python源码文件的保存编码为UTF-8，传入渲染接口的字符串本身是正确编码的Unicode字符串，没有经过错误的转码处理。
• 如果需要渲染WhatsApp的官方品牌logo，不要尝试通过字符输入实现，该logo没有对应通用Unicode编码，直接将logo导出为透明PNG矢量图插入PDF即可。

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