Java Swing JTable 复选框怎么随排序保持选中：模型索引、视图索引与刷新验收

做Java桌面开发用到Swing的JTable时，只要开启了表头点击排序，复选框很容易出现「看起来跟着行里的商品走，实际绑定的却是固定行号」的错位问题：用户明明勾选了标记库存预警的那行，排序完点保存，后台读出来的却是另一条完全不相关的记录。这个问题的根因基本都不是复选框组件本身的bug，而是开发的时候直接把屏幕上的视图行号当成了底层TableModel的模型行号用。

先复现：排序之后为什么会读错记录

假设表格有三列：是否处理、商品名称、库存数量。用户先勾选“滤芯”，然后按库存数量升序排列。此时屏幕上的第 0 行可能已经不是模型里的第 0 行。如果监听器仍然直接调用 getValueAt(viewRow, 0)，复选框状态就会和商品错配。

int viewRow = table.getSelectedRow();
boolean checked = (boolean) model.getValueAt(viewRow, 0); // 排序后有风险

这类错位问题在没开排序的时候几乎不会暴露，所以只做一次常规点击测试根本没法发现隐患。真正的验收流程要覆盖正序排序、倒序排序、主动触发模型刷新这几个关键场景。

把交互拆成两层：显示位置与业务记录

视图层只负责用户看到的顺序

JTable 的行号是视图坐标。排序器改变的是视图里的排列，表格模型仍然按原顺序保存值。单元格渲染器和编辑器也工作在这条显示链路上，因此点击事件里先保存视图行号是合理的。

模型层负责读取和保存

真正访问 TableModel 时完成转换，代码可以集中在一个小方法里，避免每个按钮监听器各写一遍：

private int toModelRow(JTable table, int viewRow) {
    if (viewRow 

这里的第 1 列是示例里的业务编号。实际开发项目里不要依赖商品名称这类可编辑字段做绑定，最好把不可见的稳定唯一ID存在模型的隐藏列里，或者直接从行对应的模型对象里取值。

组件实现：让复选框状态留在 TableModel

复选框列应返回 Boolean.class，并允许编辑。状态随模型行保存，排序时只移动视图位置。

DefaultTableModel model = new DefaultTableModel(
    new Object[][] {
        {false, "P-1002", "滤芯", 8},
        {false, "P-1001", "密封圈", 24},
        {false, "P-1003", "温度探头", 3}
    },
    new Object[] {"处理", "商品号", "名称", "库存"}
) {
    @Override
    public Class> getColumnClass(int column) {
        return column == 0 ? Boolean.class : super.getColumnClass(column);
    }
};

JTable table = new JTable(model);
table.setAutoCreateRowSorter(true);

如果保存按钮只需要读取当前选中的一行，先转成模型行号再取值；如果要批量保存所有勾选项，直接遍历模型的所有行，绝对不要遍历屏幕上的视图行：

List selectedIds = new ArrayList();
for (int modelRow = 0; modelRow 

可访问性与刷新：别让状态变化只停留在屏幕上

复选框设置为可编辑状态，不等于依赖键盘操作的用户能顺畅完成全选全消这类操作。给表格每一列设置明确的列名，空数据状态加清晰提示，复选框编辑完立刻通知底层模型同步状态。数据刷新的时候，优先用业务ID匹配合并新旧选中状态，不要直接按当前视图的行号挨个覆盖。

刷新操作做完之后至少要做三次核对：刷新前先记下所有勾选的商品号，重新加载完表格数据，最后按存下的商品号逐一检查复选框状态是否匹配。不管排序顺序怎么变，这个对应关系都不能乱。

性能检查与边界状态

几百行以内，模型遍历通常不是瓶颈；真正需要留意的是在每个单元格更新时重复加载图片、触发网络请求或重建排序器。批量更新时可以先暂停不必要的监听，再一次性调用 fireTableDataChanged，但不要为了优化而绕过模型的事件通知。

• 没有选中行的时候，保存按钮要设为禁用状态或者给出明确提示，不要把-1这类非法值直接传入模型。
• 表格过滤器生效后，部分模型行可能暂时不在视图里，做行号转换前要先校验行号的合法范围。
• 整个模型完全重建的时候，之前存的所有旧行引用全部失效，必须通过业务ID来恢复选中状态。
• 用户正在编辑复选框的时候点击刷新，要先提交未保存的编辑，或者明确提示用户有改动还没存。

相关问题

只开启排序、不使用过滤器，也需要转换行号吗？

需要。排序已经彻底改变了视图的行顺序，全链路统一做视图转模型的处理，能避免后续加行过滤器的时候埋下更难排查的隐蔽错误。

为什么不能只保存复选框所在的行号？

屏幕上的行号只是当前临时显示状态，根本不能代表记录的业务身份。存商品号、订单号这类不会变的稳定键，不管后续怎么刷新页面、怎么重新排序，都能准确恢复之前的选中状态。

刷新模型后复选框全部清空怎么办？

刷新前先把所有已选中的业务ID存入单独的集合里，加载完新数据后按ID逐一匹配重放选中状态，不要直接拿旧的模型行号给新模型赋值。

最后验收一遍

用三条测试记录跑验收最容易快速发现错位问题：勾选中间那条记录，分别按数字列升序、降序排序，再刷新一次模型，最后批量读取所有选中的ID。屏幕上行的展示位置可以变，但记录的ID、名称和复选框的选中状态，必须始终对应同一条原始业务数据。