如何让JTable遵循指定TableColumn的默认尺寸？

问题原因 #

JTable默认的autoResizeMode（自动调整模式）会在调用pack()或表格容器尺寸变化时，自动调整列宽以适应可用空间；同时JTable会基于表头、单元格内容的渲染需求计算列的最小宽度，若你设置的preferredWidth小于这个最小宽度，也会被忽略。你遇到的225像素就是自动调整后分配给列的宽度。

可行解决方案 #

方案1：关闭自动调整并锁定最小宽度 #

将JTable的自动调整模式设为AUTO_RESIZE_OFF，避免表格自动修改列宽，同时设置列的minWidth确保默认宽度生效（如果默认宽度小于内容的最小渲染宽度，需要强制覆盖）。

修改后的代码示例：

package demos.table;

import javax.swing.*;
import javax.swing.table.DefaultTableModel;
import javax.swing.table.TableColumn;

public class SOTableDemo {
    public static void main(String[] args) {
        SwingUtilities.invokeLater(() -> {
            JFrame frame = new JFrame("Simple JTable Demo");

            Object[][] data = {
                    {"John", 25},
                    {"Doe", 30},
                    {"Jane", 22},
                    {"Smith", 28}
            };
            Object[] columns = {"Name", "Age"};

            DefaultTableModel model = new DefaultTableModel(data, columns);
            JTable table = new JTable(model);

            // 关闭自动调整模式，避免表格自动修改列宽
            table.setAutoResizeMode(JTable.AUTO_RESIZE_OFF);
            
            TableColumn ageColumn = table.getColumnModel().getColumn(1);
            ageColumn.setPreferredWidth(10);
            // 设置最小宽度为10，确保默认宽度不被内容最小宽度覆盖
            ageColumn.setMinWidth(10);

            JScrollPane scrollPane = new JScrollPane(table);
            frame.add(scrollPane);

            frame.pack();
            frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
            frame.setLocationRelativeTo(null);
            frame.setVisible(true);
        });
    }
}

此时列会以10像素为初始宽度，用户仍可手动拖拽调整列宽，超出表格宽度时会显示水平滚动条。

方案2：保留自动调整但强制初始宽度比例 #

如果你希望表格仍能自动调整列宽填满空间，但初始时按你设置的比例分配宽度，可以设置列的preferredWidth后，手动指定表格的首选视口大小，避免pack()时自动覆盖列宽：

// 设置列宽
table.getColumnModel().getColumn(0).setPreferredWidth(150);
table.getColumnModel().getColumn(1).setPreferredWidth(10);
// 手动设置表格的首选视口大小，让pack()基于此计算窗口尺寸
table.setPreferredScrollableViewportSize(table.getPreferredSize());

这样pack()会遵循你设置的列宽比例来调整窗口，后续用户仍可自由调整列宽。

方案3：自定义布局时的列宽逻辑 #

如果需要更精细的控制，可以重写JTable的doLayout方法，确保每次布局时先应用你设置的默认宽度：

JTable table = new JTable(model) {
    @Override
    public void doLayout() {
        // 先强制设置目标列的宽度
        getColumnModel().getColumn(1).setWidth(10);
        // 执行默认布局逻辑
        super.doLayout();
    }
};

关键注意点 #

• setWidth()仅设置当前宽度，但JTable在布局时可能会覆盖这个值，需配合setPreferredWidth()和setMinWidth()一起使用。
• 列的默认最小宽度由表头和单元格渲染器的首选大小决定，若你的默认宽度小于这个值，必须通过setMinWidth()强制覆盖。

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