Java GridBagLayout 佈局管理器完全指南：從入門到實戰

GridBagLayout 是 Swing 中功能最強大、靈活性最高的佈局管理器，也是最複雜的。它不要求組件大小一致，能將組件垂直、水平或沿基線對齊。本文通過一個記事本實戰案例，深度講解其核心約束屬性與佈局技巧。

核心概念

• 網格單元：動態矩形網格，每個組件佔用一個或多個單元
• 顯示區域：組件佔用的單元集合
• GridBagConstraints：控制組件在網格中的位置、大小、對齊、拉伸行為的核心類

關鍵約束屬性詳解

實戰案例：記事本界面佈局

目標佈局結構（行 × 列）：

Row 0: [打開][保存][另存為][面板(佔4列)]
Row 1: [下拉框(佔2列)][文本框(佔4列,可橫向拉伸)][清空]
Row 2: [列表(佔2列,可縱向拉伸)][文本域(佔5列,可雙向拉伸)]

關鍵代碼片段

GridBagLayout layout = new GridBagLayout();
setLayout(layout);

GridBagConstraints c = new GridBagConstraints();
c.fill = GridBagConstraints.BOTH;  // 默認雙向填充

// 第1行：三個按鈕 + 面板
addButton("打開", 0, 0, 1, 1, 0, 0);
addButton("保存", 1, 0, 1, 1, 0, 0);
addButton("另存為", 2, 0, 1, 1, 0, 0);
// 面板佔4列，不拉伸，跟隨第2行文本框拉伸
c.gridwidth = GridBagConstraints.REMAINDER;  // 0
c.weightx = 0; c.weighty = 0;
layout.setConstraints(panel, c);

// 第2行：下拉框(2列) + 文本框(4列,拉伸) + 清空按鈕
c.gridwidth = 2; c.weightx = 0; c.weighty = 0;
layout.setConstraints(comboBox, c);

c.gridwidth = 4; c.weightx = 1; c.weighty = 0;  // 關鍵：weightx=1 獲得水平拉伸
layout.setConstraints(textField, c);

c.gridwidth = GridBagConstraints.REMAINDER; c.weightx = 0; c.weighty = 0;
layout.setConstraints(clearBtn, c);

// 第3行：列表(2列,縱向拉伸) + 文本域(5列,雙向拉伸)
c.gridwidth = 2; c.weightx = 0; c.weighty = 1;
layout.setConstraints(list, c);

c.gridwidth = 5; c.weightx = 1; c.weighty = 1;
layout.setConstraints(textArea, c);

避坑指南：佈局不會拉伸？

1. weightx/weighty 必須 > 0 才會分配額外空間
2. fill 必須設置（BOTH/HORIZONTAL/VERTICAL）組件才會實際變大
3. gridwidth=0 (REMAINDER) 表示該行結束，下一個組件自動換行
4. 同一列的 weightx 取最大值，同一行的 weighty 取最大值
5. 面板不設置 weightx=1 但想跟隨拉伸？設置 fill=HORIZONTAL，weightx=0，它會被同列中 weightx>0 的組件「帶動」拉伸

調試技巧

// 開啟佈局調試：顯示網格邊框
DebugGraphics.setFlashCount(0);
DebugGraphics.setFlashTime(0);
// 或繼承 JPanel 重寫 paintComponent 畫網格

總結

GridBagLayout 雖然學習曲線陡峭，但掌握 網格坐標 + 佔用範圍 + 拉伸權重 + 填充模式 這四大核心維度後，能輕松應對極其複雜的界面佈局需求。記住：先畫草圖規劃網格，再逐行配置約束 是最高效的工作流。