PyQt5中QLabel文本无法换行：如何实现固定尺寸按钮的文本换行

安全阿岳

2026-7-21

解决Qt固定尺寸按钮文本自动换行问题

先排查你可能存在的操作错误

未给QLabel开启WordWrap或TextWrapAnywhere换行属性
自定义PushButton时，内部QLabel未通过布局约束填满按钮空间，导致文本没有足够的换行区域
给QLabel设置了固定宽高，限制了文本换行的可用范围
网格布局给按钮设置了拉伸因子，打破了150x150的固定尺寸约束

具体解决方案

方案1：正确配置内嵌QLabel的属性与布局

自定义PushButton时，通过布局让QLabel填满按钮内部空间，并开启换行属性：

class WrapButton : public QPushButton {
public:
    WrapButton(const QString& text, QWidget* parent = nullptr) : QPushButton(parent) {
        setFixedSize(150, 150);
        QLabel* label = new QLabel(text, this);
        label->setWordWrap(true);
        // 如需在任意字符处换行（比如英文单词中间），添加此行
        label->setTextWrapMode(QTextOption::WrapAnywhere);
        label->setAlignment(Qt::AlignCenter); // 可选，让文本居中显示

        QVBoxLayout* layout = new QVBoxLayout(this);
        layout->setContentsMargins(5, 5, 5, 5); // 可选，留少量内边距避免文本贴边
        layout->addWidget(label);
        setLayout(layout);
    }
};

方案2：无需内嵌QLabel，直接修改QPushButton自身属性

QPushButton原生支持文本换行，只需开启对应属性即可：

QPushButton* btn = new QPushButton("这里是很长的需要自动换行的文本内容", this);
btn->setFixedSize(150, 150);
btn->setWordWrap(true);
btn->setAlignment(Qt::AlignCenter);
// 如需灵活换行，添加此行
btn->setTextWrapMode(QTextOption::WrapAnywhere);