使用GridBagLayout在JScrollPane中显示两列JLabel失败，求排查原因

你的核心问题是GridBagLayout没有为列分配足够宽度，导致新旧列表的标签被挤压到同一列显示。以下是具体分析和修复方案：

问题根源 #

你当前的代码只设置了gridx和gridy定位组件，但缺失了两个关键属性：

• weightx：决定列在容器有额外空间时的分配比例，默认值为0，意味着列会被压缩到最小宽度
• fill：控制组件是否填充所在单元格空间，默认不填充，组件仅占用自身大小的空间

这两个属性缺失会导致两列宽度被压缩到几乎为0，最终所有标签重叠在一起。

修复代码 #

修改标签添加的循环逻辑，为每一列的GridBagConstraints补充必要属性：

private void displayUpdateInfoFrame(ParseFullDoc updatedDoc) {

    // set up the frame
    JFrame updateInfoFrame = new JFrame() {
        {
            setDefaultCloseOperation(JFrame.DISPOSE_ON_CLOSE);
            setTitle("Update Information");
            getContentPane().setLayout(new GridBagLayout());
            setSize(1250, 600);
        }
    };
    ArrayList<Job> oldJobs = parseFullDoc.getJobList();
    ArrayList<Job> newJobs = filterUpdatedJobs(updatedDoc);

    final ArrayList<JLabel> jobLabels = new ArrayList<JLabel>();
    final ArrayList<Status> jobLabelStatus = new ArrayList<Status>();

    ArrayList<JLabel> newJobLabels = getInfoLabels(JOBSET.NEW, oldJobs, newJobs, jobLabels, jobLabelStatus);
    ArrayList<JLabel> oldJobLabels = getInfoLabels(JOBSET.OLD, oldJobs, newJobs, jobLabels, jobLabelStatus);

    JScrollPane infoScrollPane = new JScrollPane();
    JPanel infoPanel = new JPanel(new GridBagLayout());
    GridBagConstraints infoConstraints;

    // 添加旧列表标签（第0列）
    for (int oldIndex = 0; oldIndex < oldJobLabels.size(); oldIndex++) {
        infoConstraints = new GridBagConstraints();
        infoConstraints.gridx = 0;
        infoConstraints.gridy = oldIndex;
        infoConstraints.weightx = 0.5; // 两列均分水平空间
        infoConstraints.fill = GridBagConstraints.HORIZONTAL; // 标签水平填充单元格
        infoConstraints.insets = new Insets(3, 8, 3, 8); // 增加内边距，避免内容拥挤
        infoPanel.add(oldJobLabels.get(oldIndex), infoConstraints);
    }

    // 添加新列表标签（第1列）
    for (int newIndex = 0; newIndex < newJobLabels.size(); newIndex++) {
        infoConstraints = new GridBagConstraints();
        infoConstraints.gridx = 1;
        infoConstraints.gridy = newIndex;
        infoConstraints.weightx = 0.5;
        infoConstraints.fill = GridBagConstraints.HORIZONTAL;
        infoConstraints.insets = new Insets(3, 8, 3, 8);
        infoPanel.add(newJobLabels.get(newIndex), infoConstraints);
    }

    GridBagConstraints infoFrameConstraints = new GridBagConstraints();
    infoFrameConstraints.gridx = 0;
    infoFrameConstraints.gridy = 0;
    infoFrameConstraints.fill = GridBagConstraints.BOTH;
    infoFrameConstraints.weightx = 1.0;
    infoFrameConstraints.weighty = 1.0;

    infoScrollPane.setViewportView(infoPanel);
    updateInfoFrame.add(infoScrollPane, infoFrameConstraints);
    updateInfoFrame.setVisible(true);
}

关键修改点 #

• 每次循环新建GridBagConstraints实例，避免复用导致的属性污染
• 为weightx设置0.5，让两列均分水平可用空间
• 设置fill = GridBagConstraints.HORIZONTAL，让标签填充所在列的宽度
• 添加insets增加内边距，提升显示可读性

额外说明 #

你之前尝试的两种方案无效的原因：

• 两个并排JScrollPane：没有为每个JScrollPane设置weightx和布局约束，导致容器仅为第一个组件分配空间
• 移除JScrollPane后仍重叠：本质还是GridBagLayout的列宽配置问题，和滚动面板无关

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