使用ReplacementSpan实现TextView自定义下划线时文本换行截断问题

你遇到的第一行末尾文本被截断的问题，核心原因是ReplacementSpan的工作机制——它会把整个被标记的Span当成一个不可分割的单个布局单元来处理。TextView在计算布局时，会认为这个Span的整体宽度就是getSize方法返回的总宽度，不会将其拆分成多行来适配行宽，所以当Span总宽度超过单行可用宽度时，超出部分就会被截断，而不是自动换行。

既然我们的需求是给文本添加自定义下划线，同时保持文本正常的换行排版，完全不需要用ReplacementSpan。更合适的方案是使用LineBackgroundSpan，它可以在每行文本绘制完成后，为该行添加下划线，同时不影响文本的正常换行布局。

修改后的实现代码 #

自定义LineBackgroundSpan类

public class CustomUnderlineLineSpan implements LineBackgroundSpan {
    private int underlineColor;
    private int lineStrokeWidth;

    public CustomUnderlineLineSpan(int underlineColor, int lineStrokeWidth) {
        this.underlineColor = underlineColor;
        this.lineStrokeWidth = lineStrokeWidth;
    }

    @Override
    public void drawBackground(Canvas canvas, Paint paint, int left, int right, int top, int baseline, int bottom, CharSequence text, int start, int end, int lineNumber) {
        // 保存Paint原有属性，避免干扰文本本身的绘制
        Paint.Style originalStyle = paint.getStyle();
        int originalColor = paint.getColor();
        float originalStrokeWidth = paint.getStrokeWidth();

        // 配置下划线的绘制参数
        paint.setStyle(Paint.Style.STROKE);
        paint.setColor(underlineColor);
        paint.setStrokeWidth(lineStrokeWidth);

        // 绘制下划线，这里把下划线位置放在baseline下方4dp的位置（可根据需求调整）
        float underlineY = baseline + 4;
        canvas.drawLine(left, underlineY, right, underlineY, paint);

        // 恢复Paint原有属性，保证后续绘制不受影响
        paint.setStyle(originalStyle);
        paint.setColor(originalColor);
        paint.setStrokeWidth(originalStrokeWidth);
    }
}

应用Span的工具方法

public static Spannable getCustomUnderlineSpan(String string, int underlineColor, int textColor) {
    Spannable spannable = new SpannableString(string);
    // 设置文本颜色
    spannable.setSpan(new ForegroundColorSpan(textColor), 0, spannable.length(), Spannable.SPAN_INCLUSIVE_INCLUSIVE);
    // 添加自定义下划线
    spannable.setSpan(new CustomUnderlineLineSpan(underlineColor, 3), 0, spannable.length(), Spannable.SPAN_INCLUSIVE_INCLUSIVE);
    return spannable;
}

方案优势 #

这个方案的好处是，LineBackgroundSpan是针对每行文本独立处理的：TextView会正常对文本进行换行排版，每行绘制完成后，我们再为该行添加下划线，完全不会出现文本截断的问题，同时也能灵活自定义下划线的颜色、宽度和垂直位置。

如果一定要坚持使用ReplacementSpan，那只能手动将大Span拆分成多个适配单行宽度的小Span，但需要自己计算换行位置，处理逻辑会非常复杂，远不如LineBackgroundSpan的方案简洁可靠。

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