如何让JScrollPane适配固定尺寸JPanel，避免JFrame放大时拉伸面板？

我之前做游戏编辑器的关卡概览功能时，也踩过GridBagLayout的这个坑！问题出在GridBagLayout默认会根据容器的大小调整组件尺寸，哪怕你设了首选尺寸，只要没限制最大尺寸，窗口放大时组件就会被强制拉伸。下面是我当时解决这个问题的几个关键步骤：

• 给Canvas同时设置首选和最大尺寸
  只设preferredSize不够，必须把maximumSize也设成一样的1280×720，这样不管容器怎么放大，Canvas都不会超过这个尺寸。代码示例：

  canvas.setPreferredSize(new Dimension(1280, 720));
  canvas.setMaximumSize(new Dimension(1280, 720));
  

  如果你是自定义Canvas组件，更稳妥的方式是重写尺寸相关的方法，避免布局管理器忽略设置的值：

  @Override
  public Dimension getPreferredSize() {
      return new Dimension(1280, 720);
  }
  
  @Override
  public Dimension getMaximumSize() {
      return getPreferredSize();
  }
  

• 调整GridBagConstraints的参数
  GridBagLayout的fill和weight参数是控制组件拉伸的关键，要把它们设置成不允许拉伸的模式：

  GridBagConstraints gbc = new GridBagConstraints();
  gbc.fill = GridBagConstraints.NONE; // 禁止拉伸组件
  gbc.weightx = 0.0; // 不分配额外水平空间
  gbc.weighty = 0.0; // 不分配额外垂直空间
  gbc.anchor = GridBagConstraints.NORTHWEST; // 可选，让Canvas固定在视口左上角
  // 将Canvas添加到JScrollPane的视口时传入这个约束
  scrollPane.getViewport().add(canvas, gbc);
  

• 确认JScrollPane的视口行为
  JScrollPane默认会尊重组件的最大尺寸，所以只要上面两步做好，视口就不会强制拉伸Canvas。如果还是有问题，可以尝试设置视口的滚动模式：

  scrollPane.getViewport().setScrollMode(JViewport.SIMPLE_SCROLL_MODE);
  

这样调整后，当JFrame窗口缩小时，JScrollPane会自动显示滚动条让你查看完整的1280×720 Canvas；窗口放大时，Canvas会保持固定尺寸，不会被拉伸变形。

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