Java Swing中GridBagLayout的gridwidth属性无法正常生效问题

我在简易Swing应用中使用GridBagLayout时，gridwidth属性无法按预期生效，代码如下：

import javax.swing.JFrame;
import javax.swing.JButton;
import java.awt.GridBagLayout;
import java.awt.GridBagConstraints;

class GridBagLayt extends JFrame {
 
    GridBagLayt()
    {
        JButton jb1 = new JButton("1");
        JButton jb2 = new JButton("2");
        JButton jb3 = new JButton("3");
        JButton jb4 = new JButton("4");
        JButton jb5 = new JButton("5");
        
        GridBagLayout lay = new GridBagLayout();
        GridBagConstraints cons = new GridBagConstraints();
        
        setLayout(lay);
        cons.fill = GridBagConstraints.BOTH;
        cons.gridheight = 1;
        cons.weightx = 1;
        cons.weighty = 1;


        cons.gridx = 0; cons.gridy = 0; 
        cons.gridwidth = 2;
        lay.setConstraints(jb1, cons);
        add(jb1);
        
        cons.gridx = 2; 
        lay.setConstraints(jb2, cons);
        add(jb2);
         
        cons.gridx = 0; cons.gridy = 1; 
        cons.gridwidth = 1;
        lay.setConstraints(jb3, cons);
        add(jb3);
        
        cons.gridx = 1;
        cons.gridwidth = 2;
        lay.setConstraints(jb4, cons);
        add(jb4);
        
        cons.gridx = 3;
        cons.gridwidth = 1;
        lay.setConstraints(jb5, cons);
        add(jb5);
        
        
        setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
        setSize(700,200);
        setVisible(true);
    }
  }

public class SwingApp {
    public static void main(String[] args) {
        new GridBagLayt();
    }
}

布局预期与实际情况 #

• 期望布局：第一行按钮1占2列，按钮2占2列；第二行按钮3占1列，按钮4占2列，按钮5占1列，整体为4列均匀分布。
• 实际布局：第二行按钮4未正确占据2列，按钮5位置偏移，布局完全不符合预期。

奇怪的现象 #

如果在中间添加一行包含4个按钮（分别占据列0、1、2、3），第三行的布局就能正常显示，但我并不需要这一行的内容。添加后的代码片段如下：

// 原有第一行代码不变
cons.gridx = 0; cons.gridy = 0; 
cons.gridwidth = 2;
lay.setConstraints(jb1, cons);
add(jb1);

cons.gridx = 2; 
lay.setConstraints(jb2, cons);
add(jb2);

// 新增的中间行
cons.gridx = 0; cons.gridy = 1; 
cons.gridwidth = 1;
lay.setConstraints(jb3, cons);
add(jb3);

cons.gridx = 1;
lay.setConstraints(jb4, cons);
add(jb4);

cons.gridx = 2;
lay.setConstraints(jb5, cons);
add(jb5);

cons.gridx = 3;
lay.setConstraints(jb6, cons);
add(jb6);

// 目标布局行
cons.gridx = 0; cons.gridy = 2; 
lay.setConstraints(jb7, cons);
add(jb7);

cons.gridx = 1; cons.gridy = 2; 
cons.gridwidth = 2;
lay.setConstraints(jb8, cons);
add(jb8);

cons.gridx = 3; cons.gridy = 2; 
cons.gridwidth = 1;
lay.setConstraints(jb9, cons);
add(jb9);

此时第三行布局完全符合预期，但中间的额外行是多余的。

问题原因与解决方案 #

原因

GridBagLayout需要明确感知到所有列的存在，才能正确计算列宽和组件位置。原代码中，虽然按钮2的gridx=2、gridwidth=2理论上占据列2和3，但布局管理器没有明确标记确认列3的存在——直到新增行添加了占据列3的按钮6，才让布局管理器确认了4列的结构，后续行的gridwidth才正常生效。

解决方案

不需要添加可见的额外按钮，只需添加一个不可见组件占据列3的位置，让布局管理器识别到总共有4列。核心修改代码如下：

// 在第一行按钮1、按钮2添加完成后
cons.gridx = 3;
cons.gridwidth = 1;
JLabel invisible = new JLabel();
invisible.setVisible(false);
lay.setConstraints(invisible, cons);
add(invisible);

或者直接通过GridBagLayout的columnWeights属性指定列权重数组，明确告诉布局管理器有4列且每列权重相同：

// 初始化布局后添加
double[] columnWeights = {1.0, 1.0, 1.0, 1.0};
lay.columnWeights = columnWeights;

两种方式都能让原代码的布局达到预期效果，无需添加多余的可见组件。

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