如何让JPanel内的JTable水平超出视口以支持横向滚动

问题原因 #

你当前为JTable设置的JTable.AUTO_RESIZE_ALL_COLUMNS自动调整模式是核心诱因：该模式会强制所有列总宽度适配JScrollPane视口的宽度，无论列数多少都会自动压缩每列宽度，因此永远不会触发横向滚动条。

修复方案 #

两步修改即可实现预期效果：

• 第一步：将表格自动调整模式改为JTable.AUTO_RESIZE_OFF，关闭列宽自动压缩逻辑
• 第二步（可选）：如果需要列宽自动适配内容而非固定默认宽度，可以额外添加遍历设置列首选宽度的逻辑，保证列标题和内容可以完整显示

修改后参考代码：

private void setupReferencePanel() {
    refTable = new JTable(null, makeHeaderVector());
    refTable.addMouseListener(new TableListener(presenter));
    refListingPanel = new JPanel();
    refListingPanel.setLayout(new BorderLayout());
    refListingPanel.setBorder(BorderFactory.createTitledBorder("Reference File"));
    refScroller = new JScrollPane(refTable);
    refScroller.setHorizontalScrollBarPolicy(JScrollPane.HORIZONTAL_SCROLLBAR_AS_NEEDED);
    refTable.setFillsViewportHeight(true);

    // 核心修改：关闭自动调整列宽适配视口
    refTable.setAutoResizeMode(JTable.AUTO_RESIZE_OFF);

    // 可选：自动适配每列宽度匹配内容/标题
    for (int col = 0; col < refTable.getColumnCount(); col++) {
        TableColumn column = refTable.getColumnModel().getColumn(col);
        // 取列标题的首选宽度为基准
        int preferredWidth = (int) refTable.getTableHeader().getDefaultRenderer()
                .getTableCellRendererComponent(refTable, column.getHeaderValue(), false, false, -1, col)
                .getPreferredSize().getWidth();
        // 遍历前50行内容取最大宽度，避免内容超出列宽
        for (int row = 0; row < Math.min(refTable.getRowCount(), 50); row++) {
            int cellWidth = (int) refTable.getDefaultRenderer(refTable.getColumnClass(col))
                    .getTableCellRendererComponent(refTable, refTable.getValueAt(row, col), false, false, row, col)
                    .getPreferredSize().getWidth();
            preferredWidth = Math.max(preferredWidth, cellWidth);
        }
        // 增加10px内边距避免内容贴边
        column.setPreferredWidth(preferredWidth + 10);
    }

    refListingPanel.add(refScroller, BorderLayout.CENTER);
    refCountLbl = new JLabel("item count: 0");
    refSelect = new SelectionPanel("Selection");
    refListingPanel.add(refSelect, BorderLayout.PAGE_START);
    refListingPanel.add(refCountLbl, BorderLayout.PAGE_END);
    getContentPane().add(refListingPanel);
}

private Vector makeHeaderVector() {
    String[] cols = { ... }; // 隐藏的列名数组内容
    Vector<String> results = new Vector<String>(Arrays.asList(cols));
    return results;
}

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