QVBoxLayout中通过代码设置控件对齐失效问题

问题现象 #

尝试使用setAlignment方法修改QVBoxLayout内按钮的对齐方式时，出现了不一致的表现：

• 立即调用setAlignment，或设置0/约10毫秒的短超时调用时，功能正常；
• 设置200毫秒超时调用，或通过点击button3触发调用时，对齐设置失效。
  该问题在QHBoxLayout中不会出现，最初怀疑是Qt的Bug。

测试代码 #

from PyQt5.QtWidgets import  QApplication, QWidget, QVBoxLayout, QPushButton
from PyQt5.QtCore import  Qt, QTimer
app = QApplication([])
window = QWidget()

layout = QVBoxLayout(window)
button1 = QPushButton('button1')
button2 = QPushButton('button2')
button3 = QPushButton('Push to align button1')

layout.addWidget(button1)
layout.addWidget(button2)
layout.addWidget(button3)

# layout.setAlignment(button1, Qt.AlignTop) # 此方式生效

timeout = 200
QTimer.singleShot(timeout, lambda: layout.setAlignment(button1, Qt.AlignTop))
button3.clicked.connect(lambda: layout.setAlignment(button1, Qt.AlignTop))
window.resize(200, 600)

window.show()
app.exec()

问题原因与解决思路 #

问题并非Qt的Bug，核心原因是按钮默认的SizePolicy在垂直方向为Preferred——当布局完成后，按钮会占据自身所需的最小空间，没有多余的空间来体现AlignTop的对齐效果。

解决思路是临时将按钮的SizePolicy改为垂直方向可扩展，让布局有空间应用对齐设置，完成后再恢复默认的SizePolicy，避免按钮保持扩展状态。

解决代码 #

from PyQt5.QtWidgets import  QApplication, QWidget, QVBoxLayout, QPushButton, QSizePolicy
from PyQt5.QtCore import  Qt, QTimer
app = QApplication([])
window = QWidget()

layout = QVBoxLayout(window)
button1 = QPushButton('button1')
button2 = QPushButton('button2')
button3 = QPushButton('Push to align button1')

layout.addWidget(button1)
layout.addWidget(button2)
layout.addWidget(button3)

def align():
    # 临时设置按钮为可扩展，让布局能应用对齐
    button1.setSizePolicy(QSizePolicy.Expanding, QSizePolicy.Expanding)
    layout.setAlignment(button1, Qt.AlignTop)
    # 恢复默认SizePolicy，避免按钮保持扩展
    button1.setSizePolicy(QSizePolicy.Preferred, QSizePolicy.Preferred)

button3.clicked.connect(align)
window.resize(200, 600)

window.show()
app.exec()

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