PyQt5 Label行尾断字实现咨询：超长单词超出显示范围如何拆分

QLabel默认换行规则仅在单词边界（空格、标点等位置）换行，不会拆分单个单词，要实现带连字符的断字换行，可通过自定义QLabel结合断字计算实现，以下是两种可直接复用的实现：

方案一：符合语言断字规则的实现（依赖pyphen） #

该方案使用专业断字库匹配各语言官方断字规则，拆分位置更符合阅读习惯，支持多语言切换：

1. 先安装依赖：pip install pyphen
2. 自定义Label实现代码：

import sys
import pyphen
from PyQt5.QtWidgets import QLabel, QApplication, QWidget, QVBoxLayout
from PyQt5.QtGui import QFontMetrics

class HyphenatedLabel(QLabel):
    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        self.setWordWrap(True)
        # 可替换为其他语言代码，如中文用"zh_CN"
        self.hyphen = pyphen.Pyphen(lang='en_US')
        self._raw_text = ""
    
    def setText(self, text):
        self._raw_text = text
        self._process_hyphen()
        super().setText(self._processed_text)
    
    def _process_hyphen(self):
        if not self.width() or not self._raw_text:
            self._processed_text = self._raw_text
            return
        fm = QFontMetrics(self.font())
        available_width = self.width() - self.contentsMargins().left() - self.contentsMargins().right()
        processed_words = []
        for word in self._raw_text.split():
            word_width = fm.horizontalAdvance(word)
            if word_width <= available_width:
                processed_words.append(word)
                continue
            # 查找单词所有合法断字点
            hyphen_points = self.hyphen.positions(word)
            current_pos = 0
            split_parts = []
            last_valid_point = 0
            for point in hyphen_points:
                test_part = word[current_pos:point] + "-"
                if fm.horizontalAdvance(test_part) <= available_width:
                    last_valid_point = point
                else:
                    split_parts.append(word[current_pos:last_valid_point] + "-")
                    current_pos = last_valid_point
            split_parts.append(word[current_pos:])
            processed_words.append('\n'.join(split_parts))
        self._processed_text = ' '.join(processed_words)
    
    def resizeEvent(self, event):
        self._process_hyphen()
        super().setText(self._processed_text)
        super().resizeEvent(event)

# 测试代码
if __name__ == '__main__':
    app = QApplication(sys.argv)
    window = QWidget()
    layout = QVBoxLayout(window)
    label = HyphenatedLabel()
    label.setFixedWidth(200)
    label.setText("hello Hippopotomonstrosesquippedaliophobia hello")
    layout.addWidget(label)
    window.show()
    sys.exit(app.exec_())

方案二：无第三方依赖的轻量实现 #

适合不需要严格符合语言断字规则的简单场景，直接按像素宽度拆分：

import sys
from PyQt5.QtWidgets import QLabel, QApplication, QWidget, QVBoxLayout
from PyQt5.QtGui import QFontMetrics

class SimpleHyphenatedLabel(QLabel):
    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        self.setWordWrap(True)
        self._raw_text = ""
    
    def setText(self, text):
        self._raw_text = text
        self._process_text()
        super().setText(self._processed_text)
    
    def _process_text(self):
        if not self.width() or not self._raw_text:
            self._processed_text = self._raw_text
            return
        fm = QFontMetrics(self.font())
        available_width = self.width() - self.contentsMargins().left() - self.contentsMargins().right()
        lines = []
        current_line = ""
        for char in self._raw_text:
            test_line = current_line + char
            if fm.horizontalAdvance(test_line) <= available_width:
                current_line = test_line
            else:
                lines.append(current_line + "-")
                current_line = char
        lines.append(current_line)
        self._processed_text = "\n".join(lines)
    
    def resizeEvent(self, event):
        self._process_text()
        super().setText(self._processed_text)
        super().resizeEvent(event)

内容的提问来源于stack exchange，提问作者Mehmet Güdük