如何在Python ReportLab生成的PDF中添加彩色苹果Emoji？

ReportLab本身不支持直接渲染彩色分层字体（比如苹果的Apple Color Emoji.ttf），所以要显示彩色苹果Emoji，只能通过嵌入Emoji图片的方式实现，以下是具体步骤和代码示例：

核心思路 #

苹果Emoji的彩色效果是通过字体内部的分层矢量/位图实现的，普通PDF渲染库无法解析这种特殊字体结构。因此我们需要把文本中的Emoji替换为对应的苹果Emoji图片，再将图片插入PDF中。

实现步骤 #

1. 准备苹果Emoji图片资源

   • 从macOS系统的Apple Color Emoji.ttf字体中提取所需Emoji的PNG/SVG图片（可以用字体编辑工具如FontForge，或在线Emoji提取工具完成）。
   • 将提取好的图片按Emoji编码命名（比如apple.png对应🍎），存放在指定目录下。

2. 封装Emoji替换逻辑

   • 遍历文本，识别出Emoji字符，将其替换为ReportLab支持的Image对象，同时保留普通文本的排版。

3. 结合ReportLab生成PDF

   • 将处理后的文本段落和Emoji图片按顺序加入PDF的Flowable列表，最终生成包含彩色苹果Emoji的PDF。

代码示例 #

from reportlab.lib.pagesizes import letter
from reportlab.platypus import SimpleDocTemplate, Paragraph, Image, Spacer
from reportlab.lib.styles import getSampleStyleSheet
import emoji
import os

# 存放苹果Emoji图片的目录
EMOJI_IMG_DIR = "apple_emojis"
os.makedirs(EMOJI_IMG_DIR, exist_ok=True)

def get_emoji_image(emoji_char):
    """根据Emoji字符获取对应的本地图片路径"""
    emoji_code = emoji.demojize(emoji_char).strip(":")
    img_path = os.path.join(EMOJI_IMG_DIR, f"{emoji_code}.png")
    return Image(img_path, width=14, height=14) if os.path.exists(img_path) else None

def parse_text_with_emojis(raw_text, style):
    """将含Emoji的文本转换为ReportLab Flowables列表"""
    flowables = []
    current_text = ""
    
    for char in raw_text:
        if emoji.is_emoji(char):
            # 先处理积累的普通文本
            if current_text:
                flowables.append(Paragraph(current_text, style))
                current_text = ""
            # 添加Emoji图片
            emoji_img = get_emoji_image(char)
            if emoji_img:
                flowables.append(emoji_img)
                # 添加微小间距避免图片与文本粘连
                flowables.append(Spacer(1, 2))
        else:
            current_text += char
    
    # 处理剩余的普通文本
    if current_text:
        flowables.append(Paragraph(current_text, style))
    
    return flowables

# 生成PDF
if __name__ == "__main__":
    doc = SimpleDocTemplate("colored_emoji.pdf", pagesize=letter)
    styles = getSampleStyleSheet()
    story = []
    
    # 测试文本（包含苹果Emoji）
    test_text = "今天吃了🍎，还去🚀主题乐园玩了，开心😊！"
    
    # 解析文本为Flowables
    content_flowables = parse_text_with_emojis(test_text, styles["BodyText"])
    story.extend(content_flowables)
    
    doc.build(story)

注意事项 #

• 图片尺寸：调整Image的width和height参数，确保Emoji图片与文本行高匹配，排版更自然。
• 预生成图片：建议提前提取所有需要用到的苹果Emoji图片，避免运行时动态生成的性能开销。
• 字体兼容：普通文本仍可使用原有的字体，仅Emoji部分用图片替换，不影响整体文本样式。

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