在Java Swing开发中，JLabel默认不会根据容器宽度自动换行文本，当把JLabel放入JScrollPane时，如果文本长度超过JScrollPane的视口宽度，就会出现横向滚动条，而不是我们期望的自动换行效果。要实现JLabel在JScrollPane中自动换行，需要结合布局管理、组件尺寸配置和文本换行属性来共同实现。
核心实现原理
JLabel本身没有内置的自动换行属性，要实现换行需要借助HTML文本渲染能力，同时要让JLabel的宽度能够跟随JScrollPane的视口宽度变化，并且关闭JScrollPane的横向滚动策略，这样文本就会在达到视口宽度时自动换行，不会出现横向滚动条。
关键实现步骤
1. 使用HTML格式设置JLabel文本
JLabel支持渲染HTML格式的字符串，当文本用HTML的<html>标签包裹时，Swing会自动按照HTML的排版规则处理文本换行，这是实现自动换行的基础。
2. 配置JLabel的尺寸跟随策略
需要设置JLabel的最大宽度不超过JScrollPane的视口宽度，同时让JLabel的布局优先级为优先考虑宽度适配，这样文本才会在达到视口宽度时触发换行。
3. 调整JScrollPane的滚动策略
将JScrollPane的水平滚动策略设置为HORIZONTAL_SCROLLBAR_NEVER，禁止横向滚动条出现，确保文本只能纵向滚动。
完整代码示例
下面是一个完整的可运行示例，演示如何实现JLabel在JScrollPane中自动换行：
import javax.swing.*;
import java.awt.*;
public class JLabelAutoWrapInScrollPane {
public static void main(String[] args) {
// 创建主窗口
JFrame frame = new JFrame("JLabel在JScrollPane中自动换行示例");
frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
frame.setSize(400, 300);
// 创建长文本，用html标签包裹实现自动换行
String longText = "<html><body style='width: 100%'>这是一段非常长的文本内容，当这段文本的长度超过JScrollPane的视口宽度时，我们希望它能够自动换行而不是出现横向滚动条，通过正确的配置可以实现这个效果，现在就来演示具体的实现方式。</body></html>";
JLabel label = new JLabel(longText);
// 设置标签的最大宽度跟随父容器
label.setMaximumSize(new Dimension(Integer.MAX_VALUE, Integer.MAX_VALUE));
// 创建JScrollPane，将JLabel放入其中
JScrollPane scrollPane = new JScrollPane(label);
// 禁止横向滚动条
scrollPane.setHorizontalScrollBarPolicy(JScrollPane.HORIZONTAL_SCROLLBAR_NEVER);
// 设置纵向滚动条按需出现
scrollPane.setVerticalScrollBarPolicy(JScrollPane.VERTICAL_SCROLLBAR_AS_NEEDED);
// 设置JScrollPane的布局，让JLabel宽度跟随视口宽度
scrollPane.getViewport().setLayout(new BorderLayout());
scrollPane.getViewport().add(label, BorderLayout.CENTER);
// 将滚动面板加入窗口
frame.add(scrollPane, BorderLayout.CENTER);
frame.setVisible(true);
}
}
注意事项
- HTML文本中的
style='width: 100%'可以省略，Swing默认会按照视口宽度处理HTML文本的换行，但显式设置可以让逻辑更清晰。 - 如果JLabel的文本是动态更新的，更新后需要调用
label.revalidate()和label.repaint()让布局重新计算，确保换行效果正常生效。 - 不要给JLabel设置固定的宽度，否则换行会按照固定宽度计算，不会跟随JScrollPane的视口宽度变化。
效果验证
运行上述代码后，调整窗口宽度，会发现JLabel中的文本会跟随窗口宽度变化自动换行，JScrollPane只会出现纵向滚动条，不会出现横向滚动条，完全符合预期效果。
JLabelJScrollPane自动换行Swing修改时间：2026-07-09 11:15:10