如何在PyMuPDF的fitz模块中获取矩形内文本的最优最大字号？

PyMuPDF（fitz模块）没有直接提供这类一键计算的API，但可以利用内置的文本度量工具自行实现，以下是具体方案：

实现思路 #

通过二分法迭代测试字号，结合字体的文本边界计算功能，找到能完整放入目标矩形的最大字号：

1. 加载目标字体
2. 用二分法缩小字号范围，每次计算文本在当前字号下的宽高
3. 对比文本宽高与目标矩形的尺寸，确定是否适配

代码示例 #

def get_max_font_size(target_rect, text_content, font_name="helv"):
    # 加载指定字体
    font = fitz.Font(font_name)
    # 初始化字号搜索范围
    min_size = 1
    max_size = 1000  # 设定足够大的初始上限
    optimal_size = min_size

    # 二分法查找最大适配字号
    while min_size <= max_size:
        current_size = (min_size + max_size) // 2
        # 获取文本在当前字号下的边界矩形
        text_bbox = font.text_rect(current_size, text_content)
        text_width = text_bbox.width
        text_height = text_bbox.height

        # 检查文本是否能放入目标矩形（可根据需求添加边距）
        if text_width <= target_rect.width and text_height <= target_rect.height:
            optimal_size = current_size
            min_size = current_size + 1
        else:
            max_size = current_size - 1
    return optimal_size

补充说明 #

• font.text_rect()方法返回的是文本在指定字号下的精确边界，通过其宽高与widget的矩形（target_rect）对比，就能判断字号是否适配
• 如果需要处理多行文本，可以结合font.text_length()计算单行最大宽度，再调整换行逻辑后重新计算字号
• 得到最优字号后，直接赋值给widget的font_size属性即可，替代原有的0值解决异常问题

内容的提问来源于stack exchange，提问作者Clement Genninasca