You need to enable JavaScript to run this app. fpdf添加DejaVu UTF-8字体时为何触发pathlib接收None值的类型错误?
优惠活动
大模型
产品
解决方案
定价
更多

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包自带的内置字体目录下查找文件,根本不会读取你散落在系统各处的字体文件。

直接可跑的修复方案
  1. 先把DejaVuSansCondensed.ttf和同来源配套的字体索引文件(.ctg.z后缀),统一放到项目下的固定目录,不要散落在系统各个位置。
  2. 修改测试代码,手动给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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.04 10:54:11