使用MigLayout管理器时为何无法显示滚动条？

核心问题 #

JTextPane本质是文本编辑组件，并非为充当容器设计，它的滚动逻辑仅针对自身的文本内容，不会基于内部添加的组件计算整体尺寸，因此JScrollPane无法感知到内容超出视口范围，自然不会显示滚动条。

原因分析 #

• JTextPane的getPreferredSize()方法默认计算的是文本内容的尺寸，而非内部组件布局后的总高度/宽度，导致JScrollPane认为内容没有超出视口。
• 即便给JTextPane设置了布局管理器，Swing文本组件的容器特性被弱化，没有实现完整的容器滚动适配逻辑，换布局管理器无法解决根本问题。

解决方案 #

方案1：替换为标准容器（推荐） #

将作为容器的JTextPane替换为JPanel，JPanel是标准的Swing容器，能正确配合布局管理器和JScrollPane实现滚动：

// 替换原JTextPane为JPanel
JPanel contentPanel = new JPanel();
contentPanel.setLayout(new MigLayout("debug", "[grow]"));
contentPanel.setBorder(new LineBorder(new Color(0, 255, 0), 1, true));
                        
scrollPaneScratches = new JScrollPane(contentPanel);
scrollPaneScratches.setAutoscrolls(true);

添加组件的代码只需将textPane替换为contentPanel：

for(int key : keys) {
    JLabel header = retrieveHeader(key, types, allScratches);
                                
    contentPanel.add(header, "wrap, growy");
                            
    JTextPane txt = new JTextPane();
    txt.setText(allScratches.get(key).getScratches());
            
    contentPanel.add(txt, "wrap, growy");
}
// 添加组件后触发布局更新
contentPanel.revalidate();
contentPanel.repaint();

方案2：重写JTextPane的尺寸计算（不推荐） #

如果必须保留JTextPane作为容器，需手动重写getPreferredSize()方法，让它返回内部组件的总尺寸，同时触发布局更新：

textPane = new JTextPane() {
    @Override
    public Dimension getPreferredSize() {
        int totalHeight = 0;
        int maxWidth = getWidth();
        // 遍历所有内部组件，计算总高度
        for (Component comp : getComponents()) {
            totalHeight += comp.getPreferredSize().height;
            maxWidth = Math.max(maxWidth, comp.getPreferredSize().width);
        }
        return new Dimension(maxWidth, totalHeight);
    }
};
// 原初始化代码不变
textPane.setDoubleBuffered(true);
textPane.setLayout(new MigLayout("debug", "[grow]"));
textPane.setContentType("text/plain");
textPane.setBorder(new LineBorder(new Color(0, 255, 0), 1, true));
                    
scrollPaneScratches = new JScrollPane(textPane);
scrollPaneScratches.setAutoscrolls(true);

添加组件后必须调用：

textPane.revalidate();
textPane.repaint();

注意：这种方式可能和JTextPane的文本编辑逻辑冲突，出现布局错乱、文本渲染异常等问题，仅作为临时替代方案。

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