QTableWidget中QLineEdit对齐异常求助：回车插行滚动后错位

这个问题我之前帮同事排查过类似的！核心原因就是动态插入新行时，没有给QLineEdit和单元格同步好对齐规则、尺寸适配，导致表格刷新时控件没有正确贴合单元格。程序化填充正常是因为批量操作时表格一次性完成了布局计算，而手动插行是动态触发，需要手动补全这些设置。

下面是具体的解决步骤，亲测有效：

1. 统一单元格与QLineEdit的对齐规则 #

不管是程序化填充还是手动插行，都要保证QLineEdit的对齐和表格单元格的默认对齐完全一致。比如你希望左对齐+垂直居中，就同时设置：

from PyQt5.QtCore import Qt

# 设置QLineEdit的对齐
line_edit = QLineEdit()
line_edit.setAlignment(Qt.AlignLeft | Qt.AlignVCenter)

# 同时设置单元格的默认对齐（可选，但能避免隐性错位）
table_item = QTableWidgetItem()
table_item.setTextAlignment(Qt.AlignLeft | Qt.AlignVCenter)
table.setItem(row, col, table_item)
table.setCellWidget(row, col, line_edit)

2. 让QLineEdit自适应单元格尺寸 #

动态插行时，一定要给QLineEdit设置扩展型尺寸策略，让它完全填充单元格，避免单元格大小变化时控件“跑位”：

from PyQt5.QtWidgets import QSizePolicy

line_edit.setSizePolicy(QSizePolicy.Expanding, QSizePolicy.Expanding)

3. 插入行后强制同步表格布局 #

插入新行后，表格可能没有及时刷新控件的布局状态，手动触发一次刷新就能解决大部分错位：

# 插入新行的代码后，加上这两行
table.viewport().update()
table.updateGeometry()

4. 锁定列宽/行高的一致性 #

如果之前手动拖拽过列宽，新插入的行可能会继承不一致的尺寸，建议提前设置列宽的自适应规则：

from PyQt5.QtWidgets import QHeaderView

# 让所有列自动拉伸填充表格宽度
table.horizontalHeader().setSectionResizeMode(QHeaderView.Stretch)
# 或者固定列宽（根据你的需求选）
# table.setColumnWidth(col, 150)

完整的插入行示例函数 #

把上面的逻辑整合起来，写一个通用的插行函数：

def add_aligned_row(table):
    new_row = table.rowCount()
    table.insertRow(new_row)
    
    for col in range(table.columnCount()):
        # 创建并配置QLineEdit
        line_edit = QLineEdit()
        line_edit.setAlignment(Qt.AlignLeft | Qt.AlignVCenter)
        line_edit.setSizePolicy(QSizePolicy.Expanding, QSizePolicy.Expanding)
        
        # 设置单元格占位项（保证对齐一致）
        placeholder_item = QTableWidgetItem()
        placeholder_item.setTextAlignment(Qt.AlignLeft | Qt.AlignVCenter)
        table.setItem(new_row, col, placeholder_item)
        
        # 绑定到单元格
        table.setCellWidget(new_row, col, line_edit)
    
    # 同步布局
    table.viewport().update()
    table.updateGeometry()

用这个函数代替你原来的插行逻辑，应该就能解决错位问题了。本质上就是让动态插入的行和原有行保持完全一致的布局规则，不给表格留任何“混乱”的机会。

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