PyQt5 QTableView如何获取当前行、捕获行切换事件

核心实现原则 #

• 不要依赖entered信号做全场景选中捕获：这个信号继承自QAbstractItemView，仅在鼠标悬停条目时触发，覆盖不了键盘导航、表头点击选中的场景
• 所有选中行变更行为的统一抛出入口是QTableView绑定的*QItemSelectionModel（选择模型）*实例，不管操作来源是键盘方向键、鼠标点击单元格、点击行表头、滚动触发选中变更还是代码主动调用选中接口，都会从这个模型抛出统一信号
• 开启表格按列排序/代理过滤后，必须做视图索引到模型源索引的映射，否则会出现行号错位、读错数据的问题

基础功能实现 #

读取光标所在当前行全部数值 #

拿到当前选中索引后，先做索引映射兼容排序/过滤场景，再逐列从数据模型取值即可：

def get_current_row_data(self):
    current_index = self.tableView.currentIndex()
    if not current_index.isValid():
        return {}
    # 视图行号转模型原始行号
    table_model = self.tableView.model()
    if hasattr(table_model, 'mapToSource'):
        source_index = table_model.mapToSource(current_index)
        source_model = table_model.sourceModel()
        source_row = source_index.row()
    else:
        source_model = table_model
        source_row = current_index.row()
    # 逐列读取字段值，以列名为key存储
    row_data = {}
    for col in range(source_model.columnCount()):
        col_name = source_model.headerData(col, Qt.Horizontal)
        cell_val = source_model.index(source_row, col).data()
        row_data[col_name] = cell_val
    return row_data

捕获所有跨行导航/选中切换行为 #

直接绑定选择模型的currentRowChanged信号即可，所有选中行变更场景都会触发该信号，可在槽函数里实现自定义逻辑，比如同步Comment字段到独立QLineEdit控件：

# 初始化表格时执行一次绑定即可
select_model = self.tableView.selectionModel()
select_model.currentRowChanged.connect(self.handle_row_switch)

def handle_row_switch(self, current_idx: QModelIndex, prev_idx: QModelIndex):
    if not current_idx.isValid():
        self.comment_lineEdit.clear()
        return
    row_data = self.get_current_row_data()
    # 同步Comment字段值到输入框
    self.comment_lineEdit.setText(str(row_data.get("Comment", "")))
    # 可在此追加其他行切换时需要执行的自定义逻辑

具体技术问题修复 #

a) 方向键（上/下箭头）导航的信号捕获 #

不需要单独编写按键监听或事件过滤器：QTableView原生支持方向键移动选中项，移动导致的行变更会自动触发选择模型的currentRowChanged信号，直接复用上面绑定的槽函数即可。

仅当需要自定义方向键行为（比如跨页跳转、触发特定校验逻辑）时，才需要重写keyPressEvent做拦截处理，常规导航场景无需额外开发。

b) 点击行表头（行号列）无法触发选中的问题 #

默认状态下QTableView的垂直表头（显示行号的列）点击不会触发行选中，需要先开启表头交互属性，再绑定表头点击信号实现选中逻辑：

# 配置垂直表头属性
vertical_header = self.tableView.verticalHeader()
vertical_header.setSectionsClickable(True) # 允许点击行号触发交互
vertical_header.setHighlightSections(True) # 点击时高亮对应行表头

# 绑定表头点击事件，点击时选中整行
vertical_header.sectionClicked.connect(self.handle_header_click)

def handle_header_click(self, click_row):
    # 选中点击行号对应的整行
    self.tableView.selectRow(click_row)
    # 选中后会自动触发currentRowChanged信号，复用已有行切换逻辑
    # 若需要点击行号直接触发删除标记，可在此处直接调用删除逻辑

补充场景：Delete键标记待删除行 #

重写表格的按键Press事件，捕获Delete按键触发标记逻辑即可：

def keyPressEvent(self, event):
    if event.key() == Qt.Key_Delete:
        current_row = self.get_current_row_data()
        if current_row:
            # 执行待删除标记逻辑，比如添加删除样式、更新数据库标记字段
            self.set_row_delete_mark(current_row, mark=True)
        return
    super().keyPressEvent(event)

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