如何让QToolButton中的图标居中对齐？

针对你遇到的PyQt6.4中QToolButton图标左偏、无法居中的问题，提供以下几种可行方案：

方案1：强制固定按钮尺寸并设置图标居中对齐 #

按钮默认会自动适配图标大小，导致没有多余空间让图标居中。先设置按钮固定尺寸（比图标稍大），再强制图标居中：

from PyQt6.QtCore import Qt

# 设置按钮固定大小（根据需求调整，比如24x24）
self.toolButton_expandAll.setFixedSize(24, 24)
self.toolButton_collapseAll.setFixedSize(24, 24)
# 强制图标居中对齐
self.toolButton_expandAll.setIconAlignment(Qt.AlignmentFlag.AlignCenter)
self.toolButton_collapseAll.setIconAlignment(Qt.AlignmentFlag.AlignCenter)

方案2：通过样式表调整图标子控件的内边距 #

直接针对QToolButton的图标区域设置左右内边距，修正偏移：

# 给单个按钮设置样式，调整左右内边距（数值根据偏移量调整）
self.toolButton_expandAll.setStyleSheet("""
    QToolButton::icon {
        padding-left: 3px;
        padding-right: 3px;
    }
""")
self.toolButton_collapseAll.setStyleSheet("""
    QToolButton::icon {
        padding-left: 3px;
        padding-right: 3px;
    }
""")

方案3：统一设置图标尺寸并修正按钮适配 #

给QAction和QToolButton都明确设置图标大小，避免自动适配时的布局偏差：

from PyQt6.QtCore import QSize

# 给QAction设置图标大小
self.actionExpand_All.setIconSize(QSize(16, 16))
self.actionCollapse_All.setIconSize(QSize(16, 16))
# 同步设置按钮的图标大小
self.toolButton_expandAll.setIconSize(QSize(16, 16))
self.toolButton_collapseAll.setIconSize(QSize(16, 16))
# 同时设置按钮最小尺寸，预留居中空间
self.toolButton_expandAll.setMinimumSize(20, 20)
self.toolButton_collapseAll.setMinimumSize(20, 20)

方案4：在Qt Designer中调整属性 #

直接在UI设计阶段修正：

• 选中QToolButton，找到iconSize属性，设置为16x16
• 设置按钮的minimumSize为20x20（或更大），避免按钮紧贴图标
• 开启按钮的iconAlignment属性，选择AlignCenter

问题原因说明 #

PyQt6中QToolButton关联QAction时，默认会根据图标尺寸自动收缩按钮，加上不同风格的默认布局边距，容易导致图标偏移。通过强制按钮尺寸、调整图标对齐或内边距，就能让图标居中显示。

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