GridBagLayout 複雜度分析：為何專家建議棄用並改用巢狀面板組合策略

歷史隱喻：地心說 vs 日心說

作者以天文學演進比喻 GridBagLayout：

• 早期天文學家堅持地心說，為解釋行星逆行軌跡，發明複雜的「均輪/本輪」理論。
• GridBagLayout 如同地心說：單一布局管理器試圖解決所有對齊問題，導致 GridBagConstraints 參數爆炸 (gridx, gridy, gridwidth, gridheight, weightx, weighty, anchor, fill, insets, ipadx, ipady...)。
• 哥白尼日心說簡化一切：改用多個面板 + 簡單布局管理器組合，同樣達成複雜介面，卻大幅降低認知負荷。

GridBagLayout 痛點

• 11 個約束參數相互影響，調整一處常導致連鎖崩壞
• 視覺化編輯器生成的代碼極難人工維護
• 錯誤訊息模糊，除錯困難
• 效能較差：約束解析開銷大

推薦替代策略：巢狀面板組合法

// 外層：BorderLayout 區隔主要區域
mainPanel.setLayout(new BorderLayout());
mainPanel.add(toolbar, BorderLayout.NORTH);
mainPanel.add(content, BorderLayout.CENTER);
mainPanel.add(statusbar, BorderLayout.SOUTH);

// 內層：FlowLayout/GridLayout/BoxLayout 精細排列
content.setLayout(new GridLayout(0, 2)); // 兩欄自動換行
// 或
formPanel.setLayout(new BoxLayout(formPanel, BoxLayout.Y_AXIS));
// 或
buttonPanel.setLayout(new FlowLayout(FlowLayout.RIGHT));

優勢對比

現代補充：SpringLayout 與 JavaFX 佈局

• SpringLayout (Swing)：彈簧/支柱模型，程式碼較冗長但精確控制元件間相對關係，適合 GUI 建構器生成。
• MigLayout (第三方)：字串約束 DSL，"wrap 2, fillx, ins 5"，極度簡潔強大，社區推薦替代 GridBagLayout。
• JavaFX 佈局：GridPane (類 GridBag 但更簡潔)、HBox/VBox、BorderPane、AnchorPane、TilePane、FlowPane，配合 CSS 間距/對齊，宣告式 FXML 更直觀。