Java Swing如何通过GridBagConstraints为JPanel矩形设置布局约束

算力阿峰

2026-8-29

问题根因

你加了代码后矩形消失、没法给矩形加约束的原因有三个：

JFrame的内容面板默认使用BorderLayout，你先执行window.add(g)把自定义绘图面板加到了窗口默认的CENTER位，后面再执行window.add(layout)时，同位置的新组件会直接覆盖之前添加的g面板，原来的绘图面板根本没在当前显示的组件层级里。
Swing布局管理器是通过组件的getPreferredSize()返回值判断该给组件分配多大空间的，你自定义的GUI类没重写这个方法，默认返回的优选尺寸是0*0，就算把它正确加到GridBagLayout里，没有约束配置的情况下面板大小为0，自然看不到绘制的内容。
你在paintComponent里写死了g.fillRect(10, 10, 100, 100)，这个矩形是直接画在面板画布上的图形，不是Swing组件，本身不能直接被布局管理器管控，自然没法直接给它加布局约束。

修复方案

理顺组件层级：JFrame只添加一次使用GridBagLayout的根面板，所有其他功能面板（包括画矩形的面板、后续要加的其他元素）都作为子组件加到这个根面板上，添加时传入对应的GridBagConstraints配置，不要重复往JFrame上加同层级组件。
所有自定义绘图的JPanel必须重写getPreferredSize()，返回面板的默认期望尺寸，给布局管理器提供计算依据。
如果要让绘制的内容跟随布局调整，要么把每个矩形做成独立的JPanel组件（直接设置背景色、配置尺寸，作为普通组件加入布局），要么在绘图时动态获取当前面板的宽高计算绘制坐标，不要写死固定像素值。

可运行的修复后代码

import javax.swing.*;
import java.awt.*;

// 独立的矩形绘制面板
class RectPanel extends JPanel {
    private final Color boxColour = new Color(194, 190, 190);

    @Override
    protected void paintComponent(Graphics g) {
        super.paintComponent(g);
        g.setColor(boxColour);
        // 矩形边距留10px，大小跟随面板尺寸自动适配
        g.fillRect(10, 10, getWidth() - 20, getHeight() - 20);
    }

    @Override
    public Dimension getPreferredSize() {
        // 告诉布局管理器这个面板的首选大小是100*100
        return new Dimension(100, 100);
    }
}

public class GUIMain {
    public static void main(String[] args) {
        // Swing组件必须在事件调度线程创建，避免线程安全问题
        SwingUtilities.invokeLater(() -> {
            JFrame window = new JFrame("Java Window");
            window.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);

            // 根布局面板
            JPanel rootLayout = new JPanel(new GridBagLayout());
            GridBagConstraints constraints = new GridBagConstraints();

            // 创建第一个矩形面板
            RectPanel firstRect = new RectPanel();
            // 配置约束：放在第0列第0行，四周留15px边距
            constraints.gridx = 0;
            constraints.gridy = 0;
            constraints.insets = new Insets(15, 15, 15, 15);
            rootLayout.add(firstRect, constraints);

            // 后续要加其他矩形/组件，只需要修改gridx/gridy等约束参数，继续add到rootLayout即可
            // 示例：第二个矩形放在第1列第0行
            // RectPanel secondRect = new RectPanel();
            // constraints.gridx = 1;
            // rootLayout.add(secondRect, constraints);

            window.add(rootLayout);
            window.setSize(1280, 960);
            window.setLocationRelativeTo(null); // 窗口居中显示
            window.setVisible(true);
        });
    }
}

后续开发建议

不要把所有绘制逻辑堆在同一个面板的paintComponent里，每个独立的矩形、功能块都拆成单独的JPanel子类，各自管理自己的绘制和内部组件，后续调整布局、加功能时不会互相影响。
如果需要在矩形上放置按钮、文本等元素，直接把对应组件add到对应的矩形面板里即可，每个矩形面板可以单独设置自己的布局管理器，不用把所有组件都堆在根GridBagLayout上。
尽量避免硬编码固定坐标和固定尺寸，优先让布局管理器根据组件的优选尺寸自动计算位置和大小，减少不同系统、不同分辨率下的显示错位问题。

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