本文介绍如何通过自定义 TableCellRenderer，在 JTable 的同一单元格内并排显示图标（ImageIcon）与文字，核心是继承 DefaultTableCellRenderer 并重写 getTableCellRendererComponent 方法，结合自定义数据类实现类型安全的图文混合渲染。
本文介绍如何通过自定义 `tablecellrenderer`，在 jtable 的同一单元格内并排显示图标（imageicon）与文字，核心是继承 `defaulttablecellrenderer` 并重写 `gettablecellrenderercomponent` 方法，结合自定义数据类实现类型安全的图文混合渲染。
在 Swing 的 JTable 中，原生渲染器（如 DefaultTableCellRenderer）默认仅支持单独渲染文本或 ImageIcon——前者调用 setText()，后者调用 setIcon()，但二者无法自动共存于同一组件。然而，JLabel 本身完全支持图文混排（例如通过 setIcon() + setText() + setHorizontalTextPosition()/setVerticalTextPosition() 控制布局），因此关键在于获取并复用该 JLabel 实例，并为其注入双重内容。
解决方案分为三步：建模、渲染、注册。
1. 定义图文组合的数据载体
使用轻量级不可变类型封装图标与文本，推荐 Java 14+ 的 record：
record TextIcon(String text, ImageIcon icon) {}
该类明确表达语义，避免将 ImageIcon 和 String 混杂在 Object[] 或 Vector 中导致类型不安全。
2. 实现自定义单元格渲染器
继承 DefaultTableCellRenderer（它本质就是 JLabel 的子类），在 getTableCellRendererComponent 中识别 TextIcon 实例并设置内容：
final class MyTableCellRenderer extends DefaultTableCellRenderer {
@Override
public Component getTableCellRendererComponent(
JTable table, Object value, boolean isSelected,
boolean hasFocus, int row, int column) {
// 先执行父类默认渲染逻辑（处理选中态、背景色等）
super.getTableCellRendererComponent(
table, value, isSelected, hasFocus, row, column);
// 若单元格值为 TextIcon，则设置图文内容
if (value instanceof TextIcon textIcon) {
setText(textIcon.text());
setIcon(textIcon.icon());
// 可选：优化图文相对位置（默认图标左、文本右；可调整）
setHorizontalTextPosition(SwingConstants.RIGHT);
setVerticalTextPosition(SwingConstants.CENTER);
setIconTextGap(6); // 图标与文字间距（像素）
}
return this;
}
}
✅ 优势说明：此设计天然支持“fallback 渲染”——非
TextIcon类型（如String、Integer）将由父类DefaultTableCellRenderer按默认规则处理，无需为每列单独配置渲染器。
3. 全局注册渲染器
将渲染器设为表格的默认渲染器，覆盖所有列（利用 Object.class 的泛型基类特性）：
table.setDefaultRenderer(Object.class, new MyTableCellRenderer());
之后，在表格模型中直接返回 TextIcon 实例即可：
// 示例：TableModel 的 getValueAt() 返回
return new TextIcon("保存", new ImageIcon("save.png"));
注意事项与进阶建议
-
性能提示：
ImageIcon应预先加载并缓存（避免每次渲染重复读取文件），可配合ImageIO.read()+SwingUtilities.invokeLater异步加载。 -
对齐控制：若需图标在上、文字在下，改用
setVerticalTextPosition(SwingConstants.BOTTOM)和setHorizontalTextPosition(SwingConstants.CENTER)。 -
空值安全：在
if分支中增加textIcon.text() != null && textIcon.icon() != null判断，避免空指针。 -
扩展性：后续新增数据类型（如
TextIconBadge带徽标）只需在if块中追加分支，保持单一渲染器职责。
通过以上方式，你无需修改表格结构或引入第三方库，即可优雅、可维护地实现 JTable 单元格内的图文并茂效果。
