PyQt6无法设置精确像素尺寸与绝对定位问题求助

我想实现一个具备精确尺寸、支持绝对定位的自定义组件，需要多个组件并排显示且使用背景图，因此绝对定位是必需的。

代码示例 #

import sys

from PyQt6.QtCore import Qt, QSize
from PyQt6.QtWidgets import QApplication, QLabel, QWidget, QVBoxLayout


class MyWidget(QWidget):
    def __init__(self, num):
        super().__init__()

        self.num = str(num)
        self.setFixedSize(70, 70)

        label = QLabel(self.num)
        label.setAlignment(Qt.AlignmentFlag.AlignCenter)
        label.size = QSize(50, 50)
        label.setStyleSheet("background-color: lightblue;")
 
        label.move(100, 100)

        layout = QVBoxLayout(self)
        layout.addWidget(label)

    def sizeHint(self):
        return QSize(50, 50)
    def heightForWidth(self, width):
        return width


if __name__ == "__main__":
    app = QApplication([])

    w = QWidget()
    w.setWindowTitle("w1")
    w.show()
    w.setStyleSheet("background-color: blue;")
    w.setGeometry(600, 1500, 300, 300)
    l = QVBoxLayout(w)
    l.setSpacing(0)

    l.addWidget(MyWidget(1))
    l.addWidget(MyWidget(2))

    sys.exit(app.exec())

运行输出 #

当前存在的问题 #

• MyWidget的label在X、Y方向上始终比父组件小20像素，因此我将self.setFixedSize设为(70,70)，若设为(50,50)，label会显示为30x30像素。
• 浅蓝色方块（MyWidget.label）实际为48x48像素，而非预期的50x50。
• label.move(100,100)无任何效果。
• 目标是让MyWidget尺寸为50x50，内部label填满整个MyWidget空间，即同样为50x50像素。

问题原因与解决方法 #

1. 布局与绝对定位冲突导致move失效、尺寸收缩 #

你在MyWidget内部同时使用了绝对定位（label.move）和QVBoxLayout，这是核心矛盾：一旦给父组件设置布局，布局会完全接管子组件的位置和尺寸，label.move()的设置会被直接忽略，同时布局默认带有边距（通常上下左右各10px），这就是label比父组件小20像素的原因。

2. label.size赋值无效 #

QLabel的尺寸不能通过直接给size属性赋值来设置，这种写法完全不生效，正确的方式是调用setFixedSize或resize，但如果有布局存在，布局会覆盖这些尺寸设置。

3. label显示为48x48的原因 #

QLabel默认带有内容边距（contents margins），即使设置了固定尺寸，实际背景区域会减去默认的边距值，导致显示尺寸比设置值小2px。

修正后的代码 #

import sys

from PyQt6.QtCore import Qt, QSize
from PyQt6.QtWidgets import QApplication, QLabel, QWidget, QHBoxLayout


class MyWidget(QWidget):
    def __init__(self, num):
        super().__init__()
        self.num = str(num)
        # 设置MyWidget固定尺寸为目标的50x50
        self.setFixedSize(50, 50)
        
        label = QLabel(self.num)
        label.setAlignment(Qt.AlignmentFlag.AlignCenter)
        # 清除label的内容边距，让背景完全填满label
        label.setContentsMargins(0, 0, 0, 0)
        # 让label尺寸与父组件MyWidget完全一致
        label.resize(self.size())
        label.setStyleSheet("background-color: lightblue;")
        
        # 移除内部布局，避免干扰绝对定位逻辑
        # 直接将label的父组件设为MyWidget即可

    def sizeHint(self):
        return QSize(50, 50)
    
    def heightForWidth(self, width):
        return width


if __name__ == "__main__":
    app = QApplication([])

    w = QWidget()
    w.setWindowTitle("w1")
    w.setStyleSheet("background-color: blue;")
    w.setGeometry(600, 1500, 300, 300)
    
    # 用QHBoxLayout实现组件并排，若需绝对定位可移除布局，手动调用move设置位置
    layout = QHBoxLayout(w)
    layout.setSpacing(10)  # 可自定义组件间距
    layout.setContentsMargins(0, 0, 0, 0)  # 清除外层布局边距

    widget1 = MyWidget(1)
    widget2 = MyWidget(2)
    layout.addWidget(widget1)
    layout.addWidget(widget2)

    w.show()
    sys.exit(app.exec())

关键修正点说明 #

• 移除MyWidget内部的QVBoxLayout，避免布局干扰子组件的定位与尺寸控制。
• 让label直接以MyWidget为父组件，调用resize(self.size())实现完全填充。
• 给label设置setContentsMargins(0,0,0,0)，消除默认边距，确保背景显示为50x50。
• 外层使用QHBoxLayout实现并排需求，若需要更灵活的绝对定位，可移除外层布局，手动调用widget.move(x,y)来放置组件。

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