在 PyQt 开发中，经常需要将一段文本显示在固定宽度的区域（如标签、按钮、输入框内），并自动计算所需高度以实现自适应布局。麻烦的是，有时候并不能强制限制用户到底是输入英文还是中文（体验感太差了）。

正常来说，如果文本仅包含英文，直接使用QFontMetrics.horizontalAdvance即可准确获取宽度。但当中英文混合时，由于字符宽度差异较大（中文通常占两个英文字符宽度），仅靠字体度量有时不够直观，尤其是在需要预估行数、并结合内边距进行布局时。

本文分享一个实用的文本尺寸计算方法，它结合字符统计和实际字体度量，能精确计算文本在标签中显示所需的宽度、行数和高度，适用于中英文混合场景，实测可用。

假设我们有一个固定最大宽度的标签，需要将一段包含中文、英文、数字和标点的文本完整显示。要求：

• 如果文本总宽度小于最大宽度，则单行显示，标签宽度即为文本实际宽度。
• 如果文本超宽，则自动换行，并计算所需行数。
• 标签高度 = 行数 × 行高 + 垂直内边距。

直接使用QFontMetrics.horizontalAdvance(text)获取的宽度是不太准确的，容易出bug：
估算换行后的行数时需要知道文本在何处换行，仅用这个宽度除以最大宽度取整，会忽略换行时的断词规则（QFontMetrics提供的elidedText等虽然能处理，但不够灵活）。

另一种方法是先估算每个字符的宽度，然后累加判断换行位置。但英文字符宽度不一（如’i’和’W’差异大），单纯用固定宽度估算会产生误差。

---

算法思路

1. 字符分类统计

将文本分为三类（暂时这三类，后续有另外发现再补充）：

• 中文字符：Unicode范围\u4e00至\u9fff
• 英文字符：ASCII字符（包括字母、数字、英文标点）
• 其他字符：如中文标点（全角符号）、特殊符号

由于中文标点通常和中文字符等宽，我们将“其他字符”归入中文字符计数。

2. 设定字符基础宽度

根据常见字体（如微软雅黑、宋体）在默认字号下的显示经验，设定：

• 中文字符基础宽度：6px
• 英文字符基础宽度：3px

注意，不同设备的宽度不一样，这个是根据我自己设备调整的，具体的要自己试。

3. 结合实际字体度量

QFontMetrics.horizontalAdvance(text)返回的是字符串在当前字体下的精确像素宽度。但由于字符宽度不均，直接用它来换行判断依然需要复杂的拆词逻辑。我们将其作为一种整体偏移补偿的基准。

算法中，我们同时计算：

• actual_width：字体度量的精确宽度
• char_based_width：基于字符计数的估算宽度（中文数×6 + 英文数×3）

然后将两者相加，再加上一个固定的PADDING_COMPENSATION（内边距补偿，这个如果你自己没有可以不用写），得到最终的“文本占位宽度”。这个补偿值用于弥补字体度量与估算值之间的系统偏差，以及标签控件自身的内边距。

4. 行数计算

设定一个最大宽度MAX_WIDTH。

• 如果text_width <= MAX_WIDTH，则只需1行，标签宽度设为text_width。
• 否则，行数 = ceil(text_width / MAX_WIDTH)，标签宽度固定为MAX_WIDTH。

5. 高度计算

行高LINE_HEIGHT和垂直内边距VERTICAL_PADDING根据UI设定。最终高度 = 行数 × 行高 + 垂直内边距。

---

代码

def calculate_text_dimensions(self, text, label):
    """精确计算文本的宽度和所需行数"""
    chinese_chars = 0
    english_chars = 0
    other_chars = 0

    for char in text:
        if '\u4e00' <= char <= '\u9fff':  # 中文字符
            chinese_chars += 1
        elif char.isascii():               # ASCII字符（英文、数字、标点）
            english_chars += 1
        else:                               # 其他字符（包括中文标点）
            other_chars += 1
    chinese_chars += other_chars
    CHINESE_WIDTH = 6   # 中文字符宽度
    ENGLISH_WIDTH = 3   # 英文字符宽度
    
    font_metrics = label.fontMetrics()
    actual_width = font_metrics.horizontalAdvance(text)
    
    char_based_width = chinese_chars * CHINESE_WIDTH + english_chars * ENGLISH_WIDTH

    PADDING_COMPENSATION = 2
    
    text_width = actual_width + PADDING_COMPENSATION + char_based_width
    
    MAX_WIDTH = 800
    if text_width <= MAX_WIDTH:
        lines_needed = 1
        final_width = text_width
    else:
        lines_needed = (text_width + MAX_WIDTH - 1) // MAX_WIDTH   # 向上取整
        final_width = MAX_WIDTH
        
    LINE_HEIGHT = 27
    VERTICAL_PADDING = 4   # 上下内边距总和
    final_height = LINE_HEIGHT * lines_needed + VERTICAL_PADDING

实际应用

此函数非常适合以下场景：

• 动态标签：根据文本内容自动调整标签大小，如聊天界面中的消息气泡。
• 统计卡片：显示不定长文本，确保布局整齐。
• 表格单元格：根据内容自动调整行高。
• 自定义控件/输入框：需要精确计算绘制区域时。

总结

中英文宽度差异，比单纯使用horizontalAdvance更合理地估算换行，但是补偿值是经验常数，可能随字体、字号、控件样式变化，所以肯定还要优化（比如将补偿值改为动态计算？例如通过测量几个样本字符串的实际渲染宽度与估算宽度的差值，建立回归模型，或者直接固定支持更多字体和字号？）