如何在Pycairo中从文件加载自定义字体而非依赖系统安装？

Pycairo的select_font_face确实只能调用系统已安装的字体，但可以通过FreeType绑定的API直接从文件加载字体，具体实现如下：

1. 使用cairo.FtFontFace.create_for_file从本地字体文件创建FontFace对象
2. 通过ctx.set_font_face()将该字体应用到绘图上下文

修改后的代码示例：

import cairo

# 替换为你的字体文件实际路径
FONT_PATH = "./assets/my-font.ttf"

with cairo.ImageSurface(cairo.FORMAT_ARGB32, 200, 200) as surface:
    ctx = cairo.Context(surface)
    
    # 从文件加载字体
    try:
        font_face = cairo.FtFontFace.create_for_file(FONT_PATH, 0)
        ctx.set_font_face(font_face)
    except Exception as e:
        print(f"加载字体失败: {e}")
        # 可选： fallback到系统默认字体
        ctx.select_font_face("Sans")
    
    ctx.set_font_size(30)
    ctx.move_to(10, 50)
    ctx.show_text("Hello World")
    surface.write_to_png("hello.png")

注意事项 #

• 确保Pycairo编译时包含FreeType支持（绝大多数预编译安装包都已集成）
• 如果字体是Python包内的资源文件，建议用importlib.resources获取绝对路径，避免相对路径问题：

  from importlib.resources import files
  
  FONT_PATH = files("your_package.assets").joinpath("my-font.ttf")
  

• create_for_file的第二个参数是字体索引，适用于包含多个字体的集合文件（如.ttc），单个字体文件传入0即可

内容的提问来源于stack exchange，提问作者Right leg