在Java Swing桌面应用里，JTable默认渲染出来的表格只有统一的白色背景。为了让不同业务状态的行更直观，通常会给整行上色。很多实现直接在自定义渲染器里根据行号设置背景色，然而一旦表格滚动、排序或者数据刷新，就经常出现颜色串行、该清除的背景没有清除等问题。出现这些现象的根源不是JTable本身有缺陷，而是渲染器组件会被重复使用，颜色状态若只保存在渲染器字段中，就无法与具体的行数据保持稳定对应。本文给出的做法是把行颜色放进TableModel，渲染器只从模型读取颜色，从而实现行颜色持久化显示。
渲染器复用：颜色串行的根本原因
JTable绘制单元格时，会为每一列调用渲染器的getTableCellRendererComponent方法。这里有一个很容易忽略的细节：同一列的渲染器通常只有一个组件实例。JTable拿到这个组件绘制完当前单元格后，下一次又会用它绘制另一个单元格。也就是说，渲染器是高度复用的。
如果在自定义渲染器中只写了设置背景色的逻辑，却没有在条件不满足时恢复默认背景，上一次绘制的背景色就会残留到后续单元格上。例如用一个字段highlightRow记录需要高亮的行，绘制到该行时设置黄色背景，但下一个单元格不是高亮行时没有重新设置为白色，这个单元格就会继承黄色。即便补上了else分支，当数据行状态发生变化时，如果不触发重绘，界面上的颜色也不会自动更新。
public class BadRowRenderer extends DefaultTableCellRenderer {
private int highlightRow = -1;
public void setHighlightRow(int row) {
this.highlightRow = row;
}
@Override
public Component getTableCellRendererComponent(JTable table, Object value,
boolean isSelected, boolean hasFocus, int row, int column) {
Component c = super.getTableCellRendererComponent(table, value,
isSelected, hasFocus, row, column);
if (row == highlightRow) {
c.setBackground(Color.YELLOW);
}
// 这里缺少 else 恢复默认背景，滚动后会看到黄色块串到其他行
return c;
}
}
上面这个反例说明，把展示状态放在渲染器内部是脆弱的。渲染器适合做无状态的样式计算，真正的状态来源应该放在数据模型中。JTable的MVC结构已经提供了这种分层能力：TableModel负责数据和状态，渲染器只负责按模型状态绘制。
在TableModel中维护行颜色映射
要实现行颜色持久化，第一步是扩展TableModel。可以继承AbstractTableModel，在模型内部增加一个Map来保存每一行的背景色。键使用模型行号，值使用Color对象。业务代码只需要调用setRowColor方法修改颜色，模型内部再调用fireTableRowsUpdated通知表格刷新指定行。
这样做的好处很明显：颜色成为数据状态的一部分。无论JTable如何滚动、排序或重绘，渲染器每次读取的都是模型里的当前值，不会出现临时状态丢失的问题。同时，局部刷新只更新受影响的行，比调用fireTableDataChanged重建整个表格更高效。
import javax.swing.table.AbstractTableModel;
import java.awt.Color;
import java.util.HashMap;
import java.util.Map;
public class RowColorTableModel extends AbstractTableModel {
private final String[] columnNames = {"任务", "状态", "负责人"};
private final Object[][] data = {
{"登录模块", "进行中", "王工"},
{"支付接口", "阻塞", "李工"},
{"报表导出", "已完成", "赵工"},
{"消息推送", "进行中", "陈工"}
};
private final Map<Integer, Color> rowColors = new HashMap<>();
public Color getRowColor(int row) {
return rowColors.getOrDefault(row, Color.WHITE);
}
public void setRowColor(int row, Color color) {
rowColors.put(row, color);
fireTableRowsUpdated(row, row);
}
public void clearRowColor(int row) {
rowColors.remove(row);
fireTableRowsUpdated(row, row);
}
@Override
public int getRowCount() {
return data.length;
}
@Override
public int getColumnCount() {
return columnNames.length;
}
@Override
public String getColumnName(int column) {
return columnNames[column];
}
@Override
public Object getValueAt(int rowIndex, int columnIndex) {
return data[rowIndex][columnIndex];
}
@Override
public boolean isCellEditable(int rowIndex, int columnIndex) {
return false;
}
}
模型里的颜色值可以来自具体的业务规则。比如状态为阻塞时设置浅红色，进行中设置浅黄色，已完成设置浅绿色。规则可以写在服务类中，模型只负责保存结果。这样修改规则不需要动渲染器，也不需要动JTable初始化代码，颜色配置被集中在一处，后续维护会简单很多。
自定义渲染器读取模型颜色
有了模型状态，渲染器的职责就变得清晰了。在getTableCellRendererComponent方法中，先调用父类方法完成默认文本、边框、选中背景等基础设置，然后判断当前是否处于选中状态。非选中状态下，从模型中取出当前行颜色并设置背景。这里要注意视图行号和模型行号不一定相同，如果表格启用了排序或过滤，必须使用convertRowIndexToModel进行转换。
如果模型没有为该行指定颜色，可以回退到默认的隔行变色逻辑。比如偶数行使用浅灰色，奇数行使用白色。这样既能保留用户对斑马纹的视觉习惯，又不会覆盖业务状态色。选中行则优先使用表格的选择背景色，否则蓝色选中背景上文字可能看不清楚。
import javax.swing.*;
import javax.swing.table.DefaultTableCellRenderer;
import java.awt.Color;
import java.awt.Component;
public class RowColorRenderer extends DefaultTableCellRenderer {
@Override
public Component getTableCellRendererComponent(JTable table, Object value,
boolean isSelected, boolean hasFocus, int row, int column) {
Component c = super.getTableCellRendererComponent(table, value,
isSelected, hasFocus, row, column);
if (isSelected) {
c.setBackground(table.getSelectionBackground());
c.setForeground(table.getSelectionForeground());
return c;
}
int modelRow = table.convertRowIndexToModel(row);
if (table.getModel() instanceof RowColorTableModel) {
RowColorTableModel model = (RowColorTableModel) table.getModel();
Color rowColor = model.getRowColor(modelRow);
if (!Color.WHITE.equals(rowColor)) {
c.setBackground(rowColor);
c.setForeground(Color.BLACK);
} else {
c.setBackground(modelRow % 2 == 0 ? new Color(245, 245, 245) : Color.WHITE);
c.setForeground(Color.BLACK);
}
}
return c;
}
}
把颜色逻辑放在渲染器中读取模型，可以避免大多数颜色串行问题。因为每次绘制单元格时，渲染器都会重新向模型请求颜色，而不会依赖上一次的组件状态。即使某些操作触发了表格重绘，背景色也会根据模型中的最新值重新计算。
更新与持久化的完整示例
把模型和渲染器组合起来后，还需要在数据变化时正确刷新。比如一个任务从进行中变为阻塞，修改模型里状态列的值，同时根据新状态设置该行颜色。由于setRowColor内部已经调用fireTableRowsUpdated，界面会立即更新该行背景。如果同时修改了多个字段，建议先更新数据，再统一设置颜色，避免多次触发重绘。
import javax.swing.*;
import java.awt.BorderLayout;
import java.awt.Color;
public class RowColorDemo {
public static void main(String[] args) {
SwingUtilities.invokeLater(() -> {
RowColorTableModel model = new RowColorTableModel();
JTable table = new JTable(model);
table.setDefaultRenderer(Object.class, new RowColorRenderer());
table.setRowHeight(28);
table.setSelectionMode(ListSelectionModel.SINGLE_SELECTION);
JScrollPane scrollPane = new JScrollPane(table);
JButton updateButton = new JButton("标记第2行为阻塞");
updateButton.addActionListener(e -> {
model.setValueAt("阻塞", 1, 1);
model.setRowColor(1, new Color(255, 214, 214));
});
JFrame frame = new JFrame("JTable行颜色持久化示例");
frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
frame.setLayout(new BorderLayout());
frame.add(scrollPane, BorderLayout.CENTER);
frame.add(updateButton, BorderLayout.SOUTH);
frame.setSize(650, 280);
frame.setLocationRelativeTo(null);
frame.setVisible(true);
});
}
}
上述代码中，setValueAt会更新状态列的文字，setRowColor会把该行背景改为浅红色。按钮点击后文字和背景同时变化，且颜色不会因为窗口最小化、重新绘制而丢失。如果数据来自数据库，可以在查询结果映射为模型行后，根据业务字段批量计算颜色并填充到模型，再调用一次fireTableDataChanged即可。
如果表格支持增删行，单纯用行号作为颜色键可能不够稳定。行删除后，后面的行号会前移，原先映射的颜色会对应到错误数据。对于这种场景，更好的做法是让每一行数据对象自身携带颜色属性，TableModel只负责读取。这样颜色信息跟随数据对象存在，才算是真正的持久化。本文示例适合行顺序固定或只读型表格，实际项目中可以根据数据是否可变选择合适粒度。
Java JTable自定义渲染器行颜色持久化修改时间：2026-10-06 22:38:48