PyQt5中如何为QTableWidget单元格设置样式？padding样式表失效求解

问题根源 #

你遇到的现象是Qt样式表引擎的常见隐蔽规则导致的，和PyQt5版本、Arch运行环境没有直接关系：

• 对QTableWidget、QTreeView这类视图控件的::item子选择器，单独设置padding属性时，Qt会判定该规则没有任何可感知的视觉变更，直接跳过规则应用，不会真正把样式加载到单元格上。
• 部分Linux桌面环境自带的Qt主题（比如Arch默认搭载的Breeze主题），会内置QTableWidget的单元格默认padding值，会覆盖你写在父窗口上的级联样式表规则，进一步导致设置完全不生效。

修正方法 #

按照以下几个调整点修改代码，padding就能正常生效：

• 补全::item选择器下的基础可视化属性（哪怕是透明背景、透明边框，只要是可触发样式绘制的属性，就能让整个padding规则被引擎应用）
• 把样式表直接绑定到QTableWidget实例上，减少父控件级联样式带来的权重冲突，避免被系统主题的默认规则覆盖
• 因为Qt不会根据你设置的padding自动调整行高、列宽，需要手动设置默认行高，避免padding把内容挤到单元格边界外
• 补全单元格选中态的基础样式，避免padding生效后选中高亮区域的显示异常

可直接运行的修正代码 #

import sys
from PyQt5.QtWidgets import QApplication, QMainWindow, QTableWidget, QTableWidgetItem
from PyQt5.QtCore import Qt

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.setWindowTitle('Table Test')
        table = QTableWidget(self)
        table.setColumnCount(4)
        table.setRowCount(3)
        # 手动设置默认行高，适配padding带来的边距
        table.verticalHeader().setDefaultSectionSize(40)
        for j in range(table.rowCount()):
            for k in range(table.columnCount()):
                item = QTableWidgetItem(f"{j}{k}")
                # 给item设置居中对齐，和padding配合达到预期视觉效果
                item.setTextAlignment(Qt.AlignCenter)
                table.setItem(j, k, item)
        # 直接在表格实例上设置样式，补全基础可视化属性触发规则生效
        table.setStyleSheet("""
            QTableWidget::item {
                padding: 10px;
                background: transparent;
            }
            QTableWidget::item:selected {
                background: #2a82da;
                color: white;
            }
        """)
        self.setCentralWidget(table)
        self.resize(500, 200)

def main():
    app = QApplication(sys.argv)
    view = MainWindow()
    view.show()
    sys.exit(app.exec_())

if __name__ == '__main__':
    main()

其他实用提示 #

• 如果需要更灵活的单元格边距控制，可以自定义继承QStyledItemDelegate的委托类，在绘制单元格内容时手动计算文字偏移量，这种方式不受Qt样式表规则的限制，兼容所有Qt版本。
• 不要把padding属性和item的文字对齐属性混淆：padding是内容距离单元格边界的固定边距，文字对齐规则是内容在剩余单元格空间内的位置逻辑，两者搭配才能得到符合预期的排版效果。
• 如果设置完padding后发现选中区域的边距不对，可以单独给:selected状态的item补全相同的padding值，保证非选中和选中状态的边距一致。

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