Java Swing：JPanel加载大图片时JScrollPane滚动条不显示

滚动条不显示是SwingJScrollPane的工作机制和现有实现不匹配导致的，核心问题有两个：

• 没有为自定义的MapPanel指定正确的首选尺寸。JScrollPane判断是否显示滚动条的核心依据，是内部组件的preferredSize和滚动窗格视口尺寸的差值：只有当组件的首选尺寸大于视口尺寸时，才会显示对应方向的滚动条。现有代码虽然在paintComponent里绘制了大尺寸地图，但Swing布局管理器完全不知道这个面板需要多大的显示空间，默认会把MapPanel的尺寸拉伸到和滚动窗格视口完全一致，永远不会出现内容溢出，自然不会触发滚动条。这也是放大窗口就能看到更多图片的原因：面板大小始终和可视区域绑定，图片超出面板边界的部分直接被裁剪，根本没有进入滚动计算逻辑。
• 图片读取逻辑写在了paintComponent方法中，这个方法会在窗口重绘（缩放、移动、被遮挡后重新显示等场景）时反复触发，每次都从磁盘重新读取图片，会造成严重的性能卡顿。

只需要调整MapPanel的实现即可，MapFrame中滚动窗格的配置本身没有问题：

1. 将地图图片改为类成员变量，在构造方法中只加载一次，避免重复IO
2. 图片加载完成后，根据图片的实际宽高设置面板的首选尺寸，给JScrollPane提供正确的尺寸判断依据
3. 精简paintComponent逻辑，只保留绘制操作，不要在里面做IO等耗时操作

修正后的MapPanel代码如下：

public class MapPanel extends JPanel implements Pointable {

    private static final long serialVersionUID = 1L;
    private List<Shape> shapes = new LinkedList<>();
    // 将地图图片存为成员变量，只加载一次
    private BufferedImage mapImage;

    public MapPanel() {
        Commander.getInstance().addShapeContainer(this);
        shapeContainerState = NoState.getInstance();
        MouseHandler mouseHandler = new MouseHandler(this);
        KeyListener keyListener = new KeyListener();

        this.addMouseListener(mouseHandler);
        this.addMouseMotionListener(mouseHandler);
        this.addKeyListener(keyListener);
        this.setBackground(Color.WHITE);
        this.setFocusable(true);
        this.requestFocusInWindow();

        // 构造方法中一次性加载图片
        try {
            mapImage = ImageIO.read(new File("earthmap1.jpg"));
            // 核心：根据图片实际尺寸设置面板首选大小，供JScrollPane计算滚动条
            this.setPreferredSize(new Dimension(mapImage.getWidth(), mapImage.getHeight()));
        } catch (IOException e) {
            throw new RuntimeException("地图图片加载失败", e);
        }
    }

    @Override
    protected void paintComponent(Graphics g) {
        super.paintComponent(g);
        // 仅执行绘制逻辑，不做IO操作
        if (mapImage != null) {
            g.drawImage(mapImage, 0, 0, this);
        }
    }
}

修改完成后运行，当窗口尺寸小于地图图片尺寸时，滚动条会自动出现，拖动即可查看完整地图内容。

内容的提问来源于stack exchange，提问作者Mr.Gomer