嘿，我正好在做Swing文本组件优化的时候碰到过一模一样的问题！针对你的需求，这里有个靠谱的方案来获取JTextPane中用户可见的文本起止范围，帮你解决长文档高亮卡顿的问题：

核心思路 #

Swing的文本组件基于视图(View)和模型(Model)分离的设计，我们可以通过将可见区域的像素坐标转换为文档的字符偏移量，来精准定位用户能看到的文本范围。

具体步骤 #

• 第一步：获取可见区域矩形
  你的JTextPane肯定是放在JScrollPane里的，直接调用textPane.getVisibleRect()就能得到当前视口中实际显示的区域，这个矩形的坐标是相对于JTextPane本身的。

• 第二步：将坐标转换为文档偏移
  JTextPane提供了viewToModel(Point pt)方法，它能把组件上的像素坐标转换成对应的文档字符偏移量。我们只需要取可见区域的两个关键坐标：

  • 区域顶部的左上角：对应可见文本的起始偏移
  • 区域底部的右下角：对应可见文本的结束偏移

代码实现 #

这里给你封装一个实用方法，直接调用就能拿到起止范围：

import javax.swing.JTextPane;
import java.awt.Rectangle;
import java.awt.Point;
import javax.swing.text.BadLocationException;

public int[] getVisibleTextRange(JTextPane textPane) {
    Rectangle visibleRect = textPane.getVisibleRect();
    if (visibleRect.isEmpty()) {
        return new int[]{0, 0}; // 没有可见内容时返回空范围
    }

    // 获取可见区域顶部对应的文档起始偏移
    int startOffset = textPane.viewToModel(new Point(visibleRect.x, visibleRect.y));
    
    // 获取可见区域底部对应的文档结束偏移
    // 把x设为矩形宽度，确保覆盖该行的末尾；y设为矩形底部，包含最后一行的可见部分
    int endOffset = textPane.viewToModel(new Point(
        visibleRect.x + visibleRect.width,
        visibleRect.y + visibleRect.height
    ));

    // 可选微调：确保包含最后一行的全部可见字符
    try {
        Rectangle endRect = textPane.modelToView(endOffset);
        if (endRect.y + endRect.height > visibleRect.y + visibleRect.height) {
            // 如果endOffset对应的行超出可见区域，回退到可见区域底部对应的字符偏移
            endOffset = textPane.viewToModel(new Point(visibleRect.x, visibleRect.y + visibleRect.height));
        }
    } catch (BadLocationException e) {
        e.printStackTrace();
    }

    return new int[]{startOffset, endOffset};
}

优化建议 #

拿到这个范围后，你只需要在startOffset到endOffset之间进行Cartan关键字的查找和高亮，不用再遍历整个文档。另外建议：

• 在JScrollPane的滚动事件(AdjustmentListener)或者JTextPane的重绘事件中触发这个范围的获取和高亮更新
• 可以缓存上一次的可见范围，只有当范围变化时才重新执行高亮逻辑，进一步减少不必要的计算

内容的提问来源于stack exchange，提问作者Kuznetsov S.A.