开启QT_AUTO_SCREEN_SCALE_FACTOR致QTableWidget网格与表头边框错位

当设置环境变量QT_AUTO_SCREEN_SCALE_FACTOR=1启用自动高DPI缩放时，QTableWidget的原生或自定义网格线会与QHeaderView的边框线出现错位，且QStyledItemDelegate无法修复此问题。以下是几个经过验证的解决方案：

1. 手动控制高DPI缩放策略，避免浮点精度误差 #

自动缩放的浮点计算容易导致绘制时的像素偏移，建议在代码中手动设置缩放策略，替代环境变量：

#include <QApplication>
#include <QScreen>

int main(int argc, char *argv[])
{
    QApplication app(argc, argv);
    // 启用高DPI缩放
    app.setAttribute(Qt::AA_EnableHighDpiScaling);
    // 设置缩放因子取整策略，减少浮点误差
    app.setHighDpiScaleFactorRoundingPolicy(Qt::HighDpiScaleFactorRoundingPolicy::Round);
    // 可选：手动获取屏幕缩放因子并强制设置为整数倍
    qreal scale = app.primaryScreen()->devicePixelRatio();
    app.setScaleFactor(qRound(scale));
    
    // 初始化你的窗口和表格
    // ...
    
    return app.exec();
}

这种方式可以避免自动缩放带来的精度问题，从根源上减少错位概率。

2. 重写QHeaderView手动对齐边框 #

如果缩放策略调整无效，可通过重绘表头边框强制与表格网格线对齐：

#include <QHeaderView>
#include <QPainter>

class AlignedHeaderView : public QHeaderView
{
public:
    explicit AlignedHeaderView(Qt::Orientation orient, QWidget *parent = nullptr)
        : QHeaderView(orient, parent) {}

protected:
    void paintEvent(QPaintEvent *e) override {
        // 先调用原生绘制
        QHeaderView::paintEvent(e);
        // 手动绘制表头底部边框，确保与表格第一行网格线对齐
        QPainter painter(this);
        painter.setPen(palette().color(QPalette::WindowText));
        // 取缩放后的精确像素位置，避免偏移
        int bottom = height() - qRound(1 / devicePixelRatio());
        painter.drawLine(0, bottom, width(), bottom);
    }
};

使用时替换表格的默认表头：

QTableWidget *table = new QTableWidget(this);
table->setHorizontalHeader(new AlignedHeaderView(Qt::Horizontal, table));

通过手动计算缩放后的像素位置，让表头边框和表格网格线完全重合。

3. 用样式表统一边框规则 #

通过样式表强制表头和表格使用相同的边框样式，消除绘制差异：

QTableWidget {
    gridline-color: #ccc;
    border: none;
}
QHeaderView::section {
    border-bottom: 1px solid #ccc;
    border-right: 1px solid #ccc;
}
QTableWidget::item {
    border-right: 1px solid #ccc;
    border-bottom: 1px solid #ccc;
}

这种方式让表格和表头的边框绘制规则完全一致，在高DPI缩放时不会出现错位。

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