如何让JTextPane实现多行自动换行（等效于JTextArea的wrapStyleWord=true效果）

嘿，我完全懂你的痛点——必须保留JTextPane类，又要实现和JTextArea开了wrapStyleWord=true一样的自动换行效果对吧？确实JTextPane没有直接暴露这个属性，但我们可以通过它的文档样式或者自定义视图来搞定，下面给你两种实用的方法：

方法一：通过段落样式快速实现（最简单） #

这种方法直接利用JTextPane的StyledDocument来设置换行规则，代码量少，效果和需求完全匹配：

import javax.swing.*;
import javax.swing.text.*;
import java.awt.*;

public class Main {
    public static void main(String[] args) {
        JFrame frame = new JFrame("Test");
        JPanel myPanel = new JPanel(new BorderLayout());
        myPanel.setBorder(BorderFactory.createEmptyBorder(10, 10, 10, 10));
        
        JTextPane myTextPane = new JTextPane();
        myTextPane.setBorder(BorderFactory.createEmptyBorder(10, 10, 10, 10));
        myTextPane.setMinimumSize(new Dimension(150, 40));
        
        // 核心代码：配置自动换行（按单词拆分）
        StyledDocument doc = myTextPane.getStyledDocument();
        Style wrapStyle = doc.addStyle("WordWrapStyle", null);
        // 启用自动换行
        StyleConstants.setLineWrap(wrapStyle, true);
        // 设置按单词换行，避免把一个单词拆成两行
        StyleConstants.setWrapStyleWord(wrapStyle, true);
        // 把样式应用到整个文档的段落
        doc.setParagraphAttributes(0, doc.getLength(), wrapStyle, false);
        
        // 记得给JTextPane加滚动面板，不然内容超出边界会看不到
        myPanel.add(new JScrollPane(myTextPane));
        frame.add(myPanel);
        frame.setDefaultCloseOperation(WindowConstants.EXIT_ON_CLOSE);
        frame.pack();
        frame.setVisible(true);
    }
}

关键说明： #

• StyleConstants.setLineWrap(true)：开启自动换行功能，当文本超出JTextPane宽度时自动换行
• StyleConstants.setWrapStyleWord(true)：确保换行时不会拆分单个单词，和JTextArea的wrapStyleWord效果完全一致
• 最后把这个样式全局应用到文档的所有段落，就能实现你要的效果

方法二：自定义EditorKit（更灵活） #

如果你的场景需要更自定义的视图逻辑，可以通过继承StyledEditorKit来实现，这种方法扩展性更强：

import javax.swing.*;
import javax.swing.text.*;
import java.awt.*;

public class Main {
    public static void main(String[] args) {
        JFrame frame = new JFrame("Test");
        JPanel myPanel = new JPanel(new BorderLayout());
        myPanel.setBorder(BorderFactory.createEmptyBorder(10, 10, 10, 10));
        
        JTextPane myTextPane = new JTextPane();
        myTextPane.setBorder(BorderFactory.createEmptyBorder(10, 10, 10, 10));
        myTextPane.setMinimumSize(new Dimension(150, 40));
        
        // 替换默认的EditorKit为自定义的换行版本
        myTextPane.setEditorKit(new WrapEditorKit());
        
        myPanel.add(new JScrollPane(myTextPane));
        frame.add(myPanel);
        frame.setDefaultCloseOperation(WindowConstants.EXIT_ON_CLOSE);
        frame.pack();
        frame.setVisible(true);
    }

    // 自定义支持换行的EditorKit
    static class WrapEditorKit extends StyledEditorKit {
        private final ViewFactory viewFactory = new WrapColumnFactory();

        @Override
        public ViewFactory getViewFactory() {
            return viewFactory;
        }

        // 自定义视图工厂，替换段落视图为支持换行的版本
        private static class WrapColumnFactory implements ViewFactory {
            @Override
            public View create(Element elem) {
                String elemName = elem.getName();
                if (elemName != null) {
                    switch (elemName) {
                        case AbstractDocument.ParagraphElementName:
                            return new WrapParagraphView(elem);
                        case AbstractDocument.ContentElementName:
                            return new LabelView(elem);
                        case AbstractDocument.SectionElementName:
                            return new BoxView(elem, View.Y_AXIS);
                        case StyleConstants.ComponentElementName:
                            return new ComponentView(elem);
                        case StyleConstants.IconElementName:
                            return new IconView(elem);
                    }
                }
                return new LabelView(elem);
            }
        }

        // 自定义段落视图，强制实现按单词换行
        private static class WrapParagraphView extends ParagraphView {
            public WrapParagraphView(Element elem) {
                super(elem);
            }

            @Override
            protected SizeRequirements calculateMinorAxisRequirements(int axis, SizeRequirements r) {
                if (axis == View.X_AXIS) {
                    super.calculateMinorAxisRequirements(axis, r);
                    // 强制宽度匹配组件可用空间，触发自动换行
                    r.minimum = r.preferred;
                }
                return r;
            }
        }
    }
}

关键说明： #

• 我们通过自定义WrapEditorKit替换了JTextPane默认的EditorKit，重写了视图工厂
• 自定义的WrapParagraphView会强制段落视图在水平方向上匹配组件宽度，从而实现自动换行，同时默认就支持按单词拆分

两种方法都能满足你的需求，推荐第一种简单的样式设置方法，除非你需要更复杂的自定义视图逻辑。

备注：内容来源于stack exchange，提问作者demavi