使用Python FPDF生成Unicode泰卢固语PDF渲染异常求助

核心问题原因 #

旧版FPDF库对Unicode复杂脚本（如泰卢固语的连字、字形组合）支持有限，必须使用维护更新的fpdf2库（原FPDF的官方fork），同时要正确配置字体嵌入参数。

修正后的代码示例 #

from fpdf import FPDF

# 初始化PDF，设置页面
pdf = FPDF()
pdf.add_page()

# 嵌入泰卢固语字体，必须指定uni=True启用Unicode支持
# 注意：替换为你的NotoSansTelugu-Regular.ttf实际路径
pdf.add_font("NotoSansTelugu", "", "./NotoSansTelugu-Regular.ttf", uni=True)

# 设置当前字体为泰卢固语字体
pdf.set_font("NotoSansTelugu", size=14)

# 泰卢固语文本示例
telugu_content = "నమస్కారం! పైథాన్ ద్వారా PDF లో తెలుగు వచనాలను ప్రదర్శించడం"

# 写入文本到PDF
pdf.cell(200, 10, txt=telugu_content, ln=True, align='C')

# 保存输出PDF
pdf.output("telugu_pdf_output.pdf")

关键注意事项 #

• 升级到fpdf2：卸载旧版FPDF，安装fpdf2：pip uninstall fpdf -y && pip install fpdf2
• 字体路径正确：确保add_font中的字体文件路径是绝对路径或相对当前脚本的正确路径
• 必须加uni=True：该参数告诉fpdf2启用Unicode编码支持，否则会默认使用Latin-1导致乱码
• 验证字体完整性：确认NotoSansTelugu-Regular.ttf文件未损坏，用系统字体工具打开能正常显示泰卢固语字符

排查步骤（如果仍有问题） #

1. 先测试单个泰卢固字符，排除特定复杂字形的问题
2. 检查fpdf2版本：运行pip show fpdf2，确保版本≥2.7.0（新版本修复了更多Unicode渲染问题）
3. 尝试其他泰卢固语字体（如Noto Sans Telugu Bold），排除字体本身的兼容性问题

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