Python FPDF韩文使用求助：安装韩文字体仍无法生成韩文文档

要解决FPDF无法生成韩文文档的问题，核心是处理Unicode字体嵌入和使用维护版的FPDF库，具体步骤如下：

1. 切换到fpdf2库 #

原版FPDF对非ASCII字符（如韩文）的支持有限，推荐使用fpdf2——这是FPDF的现代维护分支，原生支持Unicode字符。先安装或升级到最新版：

pip install --upgrade fpdf2

2. 准备韩文字体文件 #

不需要依赖系统安装的字体，直接将韩文字体文件（如开源的Noto Sans Korean）放到项目目录中。你可以下载对应字体（比如NotoSansKR-Regular.ttf），确保文件路径正确。

3. 编写代码嵌入字体并生成韩文PDF #

示例代码如下：

from fpdf import FPDF

# 初始化PDF，默认页面为A4
pdf = FPDF()
pdf.add_page()

# 添加韩文字体，uni=True表示启用Unicode支持
pdf.add_font('NotoSansKR', '', 'NotoSansKR-Regular.ttf', uni=True)

# 设置当前使用的字体及字号
pdf.set_font('NotoSansKR', size=12)

# 写入韩文内容，确保字符串是UTF-8编码
pdf.cell(200, 10, txt="안녕하세요! FPDF2로 한국어 문서를 생성하는 예시입니다.", ln=True, align='C')

# 保存生成的PDF
pdf.output("korean_output.pdf")

常见问题排查 #

• 字体路径错误：如果字体文件不在项目根目录，需填写绝对路径（如/home/user/fonts/NotoSansKR-Regular.ttf）
• 版本问题：确认fpdf2版本≥2.5.0，旧版本可能存在Unicode支持漏洞
• 字符编码问题：确保你的Python脚本和输入的韩文字符串都是UTF-8编码（Python 3默认支持）

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