QHorizontalLayout下QTableView与QWebEngineView尺寸分配异常求助

问题现象 #

同属QHBoxLayout的QTableWidget与QWebEngineView空间分配异常，某一方占据绝大多数空间，另一方几乎无显示区域：

问题根源 #

布局异常核心原因有两点：

1. 拉伸因子设置时机错误：在init_pdf_view中调用setStretch(1,1)时，布局内仅存在刚添加的pdf_view（位于索引0），索引1不存在，该设置无效；后续插入table到索引0后，两个控件的拉伸因子均为默认值0，布局会按照控件默认sizeHint分配空间，QTableWidget默认sizeHint宽度远大于未加载完成的QWebEngineView，因此表格占满绝大多数空间。
2. 拉伸因子设置不全：后续尝试单独给索引1的pdf_view设置拉伸因子1时，table的拉伸因子仍为0，布局会将所有剩余空间分配给唯一stretch>0的pdf_view，因此反向出现PDF视图占满、表格无空间的问题。

布局分配修复方案 #

1. 等两个控件全部添加到布局后，统一按比例设置两个控件的拉伸因子，不要在单个控件初始化方法中单独设置。例如需要两个控件初始平分宽度，在两个init方法都调用完成后添加如下代码：

# 索引0为QTableWidget，索引1为QWebEngineView，拉伸比例1:1即平分宽度，可按需调整数值比例
self.horizontalLayout_2.setStretch(0, 1)
self.horizontalLayout_2.setStretch(1, 1)

2. 给两个控件设置最小宽度，避免极端情况下被压缩到不可见：

self.table.setMinimumWidth(300)
self.pdf_view.setMinimumWidth(400)

表格自定义效果实现方案 #

1. 非首列宽度限制+水平滚动条配置 #

填充完表格数据后添加如下代码，实现非首列最大宽度不超过表格可用宽度的一半，总宽度超出时自动显示水平滚动条：

# 按你使用的PyQt/PySide版本调整导入路径
from PyQt5.QtCore import Qt
from PyQt5.QtWidgets import QHeaderView

# 配置滚动条显示策略
self.table.setHorizontalScrollBarPolicy(Qt.ScrollBarAsNeeded)
self.table.setVerticalScrollBarPolicy(Qt.ScrollBarAsNeeded)
header = self.table.horizontalHeader()

# 动态计算非首列最大宽度（表格当前可用宽度的一半）
max_other_col_width = self.table.viewport().width() // 2
# 首列设为固定宽度，可按需调整数值
header.setSectionResizeMode(0, QHeaderView.Fixed)
self.table.setColumnWidth(0, 160)

# 配置其余列：自适应内容宽度，超过最大值则固定为最大值，允许拖动调整
for col in range(1, self.table.columnCount()):
    header.setSectionResizeMode(col, QHeaderView.ResizeToContents)
    col_w = self.table.columnWidth(col)
    if col_w > max_other_col_width:
        self.table.setColumnWidth(col, max_other_col_width)
        header.setSectionResizeMode(col, QHeaderView.Interactive)

如果需要窗口缩放时自动更新列最大宽度，重写窗口的resizeEvent方法，在里面重新执行上述宽度计算和设置逻辑即可。

2. 首列固定不随水平滚动偏移 #

通过叠加冻结列表格的方式实现，在表格初始化完成后添加如下代码：

# 创建冻结列，仅显示第一列
self.frozen_col = QtWidgets.QTableWidget(self.table)
self.frozen_col.setColumnCount(1)
self.frozen_col.setRowCount(self.table.rowCount())
self.frozen_col.verticalHeader().hide()
self.frozen_col.horizontalHeader().setSectionResizeMode(QHeaderView.Fixed)
self.frozen_col.setHorizontalScrollBarPolicy(Qt.ScrollBarAlwaysOff)
self.frozen_col.setVerticalScrollBarPolicy(Qt.ScrollBarAlwaysOff)
self.frozen_col.setFrameShape(QtWidgets.QFrame.NoFrame)
self.frozen_col.setEditTriggers(QtWidgets.QAbstractItemView.NoEditTriggers) # 不需要冻结列可编辑可保留该行

# 同步首列内容
def sync_frozen_col():
    self.frozen_col.setRowCount(self.table.rowCount())
    for row in range(self.table.rowCount()):
        item = self.table.item(row, 0)
        self.frozen_col.setItem(row, 0, item.clone() if item else None)
sync_frozen_col()

# 同步垂直滚动
self.table.verticalScrollBar().valueChanged.connect(self.frozen_col.verticalScrollBar().setValue)
self.frozen_col.verticalScrollBar().valueChanged.connect(self.table.verticalScrollBar().setValue)

# 调整冻结列位置，始终覆盖在原表格第一列位置
def update_frozen_col_geom():
    self.frozen_col.setGeometry(
        self.table.verticalHeader().width() + self.table.frameWidth(),
        self.table.frameWidth(),
        self.table.columnWidth(0),
        self.table.viewport().height() + self.table.horizontalHeader().height()
    )
self.table.horizontalHeader().sectionResized.connect(lambda idx, _, new_w: (self.frozen_col.setColumnWidth(0, new_w), update_frozen_col_geom()) if idx ==0 else None)
self.table.verticalHeader().sectionResized.connect(update_frozen_col_geom)
origin_resize = self.table.resizeEvent
def new_resize(e):
    origin_resize(e)
    update_frozen_col_geom()
self.table.resizeEvent = new_resize

# 原表格视口留出首列位置，避免内容被冻结列遮挡
self.table.setViewportMargins(self.table.columnWidth(0), 0, 0, 0)
update_frozen_col_geom()

每次更新表格数据（增删行、修改首列内容）后，调用sync_frozen_col()同步内容即可避免错位。

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