我之前在使用Qt的QTableWidget时也碰到过一模一样的问题——文本颜色能正常修改，但背景色死活不生效，折腾了好久才找到核心原因，咱们一步步来排查：

1. 优先排查样式表冲突 #

Qt的样式表（QSS）优先级非常高，如果你的QTableWidget或者它的父控件设置了类似这样的全局样式：

QTableWidget::item {
    background-color: #ffffff;
}

那你通过setBackground()设置的自定义颜色会被完全覆盖。临时验证方案：先把所有样式表代码注释掉，运行程序看看背景色是否正常显示。如果生效了，就说明是样式表的问题。

如果需要保留全局样式表，你可以给特殊的item添加自定义标记，然后在样式表里针对性匹配：

// 给需要特殊背景的item设置一个用户角色标记
name->setData(Qt::UserRole, QVariant("highlighted"));

对应的样式表写法：

QTableWidget::item[userRole="highlighted"] {
    background-color: yourCustomColor;
}

2. 关闭交替行颜色功能 #

如果你的sampleTable开启了alternatingRowColors（交替行颜色），这个属性会强制给奇数/偶数行设置固定背景，直接覆盖item自身的背景色。你可以通过代码关闭测试：

sampleTable->setAlternatingRowColors(false);

先确认关闭后背景色是否生效，再决定是否需要保留这个功能。

3. 检查颜色本身是否有效 #

有时候不是代码逻辑的问题，而是sampleInfoColor[i]里的颜色本身有问题——比如是全透明的QColor(0,0,0,0)，或者RGB值设置错误。你可以先替换成一个明确的颜色测试：

name->setBackground(QColor(Qt::red)); // 直接设置红色，看能不能显示

同时可以打印颜色值确认有效性：

qDebug() << sampleInfoColor[i]; // 查看RGB和alpha通道的值是否正常

4. 调整背景色的设置顺序 #

虽然理论上设置item到table前后设置背景色都可以，但有时候table的刷新机制会导致后设置的背景色不生效。你可以把设置背景色的代码放到setItem()之前：

QTableWidgetItem *name = new QTableWidgetItem("Text");
name->setFont(nameFont);
name->setBackground(sampleInfoColor[i]); // 先设置背景
sampleTable->setItem(i+1, 0, name); // 再添加到table

如果还是不行，手动触发table的刷新：

sampleTable->viewport()->update();

5. 确认item的flags权限 #

虽然默认情况下QTableWidgetItem的flags是允许修改样式的，但如果不小心修改了flags，可能会导致无法设置背景。你可以打印flags检查：

qDebug() << name->flags();

正常情况下应该包含Qt::ItemIsSelectable和Qt::ItemIsEnabled，如果缺少的话，重新设置：

name->setFlags(Qt::ItemIsSelectable | Qt::ItemIsEnabled);

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