Android RecyclerView长文本Item滚动卡顿问题解决咨询

核心思路 #

卡顿的本质是超长文本在UI线程执行排版计算导致的——TextView设置超长字符串时，需要逐字符计算排版、测量宽度，这在RecyclerView滚动（高频调用onBindViewHolder）时会严重阻塞UI线程。你的裁剪思路是对的，关键是高效计算可显示的最大字符数+缓存结果，避免重复计算。

具体实现步骤 #

1. 工具方法：计算TextView可容纳的最大字符数

用Paint.breakText()替代getTextBounds，这是Android专门用于计算一行文本可容纳字符数的API，效率更高：

import android.text.TextUtils;
import android.graphics.Paint;

public class TextUtilsEx {
    public static int getMaxVisibleCharCount(Paint paint, String text, int maxAvailableWidth) {
        if (TextUtils.isEmpty(text) || maxAvailableWidth <= 0) {
            return 0;
        }
        // breakText参数：文本、是否限制宽度、最大可用宽度、返回测量宽度的数组（可传null）
        return paint.breakText(text, true, maxAvailableWidth, null);
    }
}

2. 给数据模型添加缓存字段

在NoteItem类中新增缓存字段，避免每次onBind重复计算裁剪文本：

public class NoteItem {
    private String noteTitle;
    private String noteDetails;
    private String cachedShortDetails; // 缓存裁剪后的详情文本

    // 原有getter/setter
    public String getNoteTitle() { return noteTitle; }
    public String getNoteDetails() { return noteDetails; }

    // 缓存相关方法
    public String getCachedShortDetails() { return cachedShortDetails; }
    public void setCachedShortDetails(String cachedShortDetails) { this.cachedShortDetails = cachedShortDetails; }
}

3. 在onBindViewHolder中高效设置文本

优先使用缓存结果，仅在首次显示时计算，同时处理TextView未完成测量的情况：

@Override
public void onBindViewHolder(@NonNull NoteViewHolder holder, int position) {
    NoteItem noteItem = mNoteList.get(position);

    // 设置标题（短文本直接处理即可）
    holder.noteTitleText.setText(noteItem.getNoteTitle());

    String fullDetails = noteItem.getNoteDetails();
    if (TextUtils.isEmpty(fullDetails)) {
        holder.noteDetailsText.setText("");
        return;
    }

    // 优先使用缓存的裁剪文本
    String shortDetails = noteItem.getCachedShortDetails();
    if (shortDetails != null) {
        holder.noteDetailsText.setText(shortDetails);
        return;
    }

    // 获取TextView可用宽度（减去左右padding）
    int availableWidth = holder.noteDetailsText.getWidth() 
            - holder.noteDetailsText.getPaddingLeft() 
            - holder.noteDetailsText.getPaddingRight();

    if (availableWidth <= 0) {
        // TextView尚未完成测量，先设置默认短文本，后续监听测量完成后再更新
        holder.noteDetailsText.setText(fullDetails.substring(0, Math.min(50, fullDetails.length())));
        // 监听布局完成事件，重新计算
        holder.noteDetailsText.getViewTreeObserver().addOnGlobalLayoutListener(new ViewTreeObserver.OnGlobalLayoutListener() {
            @Override
            public void onGlobalLayout() {
                // 移除监听，避免重复触发
                holder.noteDetailsText.getViewTreeObserver().removeOnGlobalLayoutListener(this);
                // 重新计算可用宽度
                int finalWidth = holder.noteDetailsText.getWidth() 
                        - holder.noteDetailsText.getPaddingLeft() 
                        - holder.noteDetailsText.getPaddingRight();
                int maxChars = TextUtilsEx.getMaxVisibleCharCount(holder.noteDetailsText.getPaint(), fullDetails, finalWidth);
                String cachedText = fullDetails.substring(0, maxChars);
                noteItem.setCachedShortDetails(cachedText);
                holder.noteDetailsText.setText(cachedText);
            }
        });
        return;
    }

    // 首次计算并缓存
    int maxChars = TextUtilsEx.getMaxVisibleCharCount(holder.noteDetailsText.getPaint(), fullDetails, availableWidth);
    shortDetails = fullDetails.substring(0, maxChars);
    noteItem.setCachedShortDetails(shortDetails);
    holder.noteDetailsText.setText(shortDetails);
}

额外优化建议 #

• 预计算裁剪文本：如果数据从本地/网络加载，可在加载阶段（子线程）提前计算所有NoteItem的裁剪文本，onBind时直接设置，完全避免UI线程计算。
• 支持展开功能：若需要展示完整文本，可给TextView添加点击事件，点击后切换显示完整内容（此时用户停止滚动，排版计算不会影响流畅度）。
• 简化TextView属性：避免给TextView设置autoSizeTextType等额外排版属性，这类属性会增加文本测量的耗时。

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