fpdf添加DejaVu UTF-8字体时为何触发pathlib接收None值的类型错误?
报错根本原因
触发TypeError: expected str, bytes or os.PathLike object, not NoneType和系统字体存放位置、Mac权限没有任何关系。问题出在你当前使用的PyFPDF 1.x版本(即pip仓库中的fpdf包):add_font方法内部用于定位字体的parent变量,本质是PDF对象的font_dir属性,这个属性默认初始值为None。代码执行到路径拼接逻辑时,直接把None传入Path构造函数,在还没开始查找字体文件的阶段就抛出了错误。
你之前把DejaVu字体文件夹复制到Mac各个系统目录的操作完全无效——这个版本的PyFPDF不会主动扫描全局系统字体路径,只会从font_dir指定的目录、以及fpdf包自带的内置字体目录下查找文件,根本不会读取你散落在系统各处的字体文件。
直接可跑的修复方案
- 先把
DejaVuSansCondensed.ttf和同来源配套的字体索引文件(.ctg.z后缀),统一放到项目下的固定目录,不要散落在系统各个位置。 - 修改测试代码,手动给
font_dir赋值为字体所在目录的绝对路径,从根源上避免None值问题:from fpdf import FPDF from pathlib import Path # 替换为你实际存放字体的绝对路径 FONT_DIR = Path("/Users/brc/Documents/Python/AvenidasPython/fonts") FONT_FILE = "DejaVuSansCondensed.ttf" pdf = FPDF('L', 'mm', 'A4') pdf.font_dir = str(FONT_DIR) pdf.add_page() pdf.add_font('DejaVu', '', FONT_FILE, uni=True)
额外注意事项
- 也可以直接在
add_font方法中传入字体文件的完整绝对路径,不需要手动设置font_dir属性,同样可以绕过None值报错:pdf.add_font('DejaVu', '', "/Users/brc/Documents/Python/AvenidasPython/fonts/DejaVuSansCondensed.ttf", uni=True) - 加载TTF字体时必须保证同目录下存在配套的.ctg.z索引文件,否则就算路径正确,后续也会触发字体解析失败的问题。
内容的提问来源于stack exchange,提问作者Bernardo Ribeiro da Cunha
相关产品推荐
相关产品推荐

