Swing实现折叠面板遇问题：setVisible()致父容器高度计算错误

核心问题分析 #

使用垂直方向BoxLayout时，直接调用setVisible()切换子面板显示状态后，布局管理器未正确计算容器首选尺寸，导致父容器高度异常、组件跳动或位置偏移。

可行修复步骤 #

1. 正确触发布局更新流程 #

不要直接设置父容器尺寸，切换可见性后按以下顺序调用方法：

// 切换折叠面板可见性
collapsiblePanel.setVisible(!collapsiblePanel.isVisible());
// 触发布局重计算与界面重绘
parentContainer.revalidate();
parentContainer.repaint();
// 若父容器在JScrollPane内，同步更新视口
scrollPane.getViewport().revalidate();

revalidate()会让布局管理器重新计算所有组件尺寸，repaint()确保界面刷新，视口的revalidate()可解决滚动面板内的位置偏移问题。

2. 给折叠面板设置尺寸约束 #

BoxLayout优先使用组件的getPreferredSize()，折叠状态下需强制面板高度为0：

// 折叠时锁定高度
collapsiblePanel.setMaximumSize(new Dimension(Integer.MAX_VALUE, 0));
collapsiblePanel.setPreferredSize(new Dimension(Integer.MAX_VALUE, 0));
// 展开时恢复原尺寸
collapsiblePanel.setMaximumSize(new Dimension(Integer.MAX_VALUE, Short.MAX_VALUE));
collapsiblePanel.setPreferredSize(collapsiblePanel.getMinimumSize());

通过固定尺寸约束，让BoxLayout严格计算容器高度，避免组件跳动。

3. 替换BoxLayout为SpringLayout（可选） #

若BoxLayout的约束无法满足需求，SpringLayout可精准控制组件依赖关系：

SpringLayout layout = new SpringLayout();
parentContainer.setLayout(layout);
// 绑定折叠面板底部与父容器，折叠时调整弹簧长度
Spring panelHeight = Spring.height(collapsiblePanel);
layout.putConstraint(SpringLayout.SOUTH, parentContainer, 
                    collapsiblePanel.isVisible() ? panelHeight : Spring.constant(0), 
                    SpringLayout.SOUTH, collapsiblePanel);

4. 消除元素跳动的细节处理 #

JLabel toggleIcon = new JLabel("▼");
toggleIcon.setMinimumSize(new Dimension(20, 20));
toggleIcon.setPreferredSize(new Dimension(20, 20));