Android TextView设置lineSpacingExtra时BackgroundColorSpan背景出现多余内边距问题

问题根因 #

系统自带的BackgroundColorSpan在绘制时，会直接使用行布局回调传入的、包含全部行间距的整行上下边界绘制矩形，不会单独计算文字本身的字形高度。当TextView设置lineSpacingExtra后，整行的实际高度会在文字字形高度的基础上增加额外间距，因此背景矩形会把这部分额外间距也包含进去，出现底部多余的内边距效果。

可行修复方案 #

方案1：自定义适配文字高度的背景Span（推荐） #

放弃系统自带的BackgroundColorSpan，自定义基于ReplacementSpan实现的背景绘制逻辑，绘制时直接取文字本身的字形度量值，完全不受行间距配置的影响。

自定义Span实现代码：

class TextBackgroundSpan(
    private val backgroundColor: Int,
    private val verticalPadding: Int = 0 // 可按需设置文字上下的背景内边距
) : ReplacementSpan() {
    override fun getSize(
        paint: Paint,
        text: CharSequence?,
        start: Int,
        end: Int,
        fm: Paint.FontMetricsInt?
    ): Int {
        // 不改变原有文字的测量逻辑，直接返回文字实际宽度
        return paint.measureText(text, start, end).toInt()
    }

    override fun draw(
        canvas: Canvas,
        text: CharSequence?,
        start: Int,
        end: Int,
        x: Float,
        top: Int,
        y: Int,
        bottom: Int,
        paint: Paint
    ) {
        // 取画笔对应的真实文字字形边界，完全忽略传入的带行间距的top/bottom
        val fontMetrics = paint.fontMetricsInt
        val textTop = y + fontMetrics.ascent
        val textBottom = y + fontMetrics.descent
        val textWidth = getSize(paint, text, start, end, null)

        // 定义贴合文字高度的背景矩形，可叠加自定义垂直内边距
        val bgRect = Rect(
            x.toInt(),
            textTop - verticalPadding,
            (x + textWidth).toInt(),
            textBottom + verticalPadding
        )

        // 先绘制背景
        val originColor = paint.color
        paint.color = backgroundColor
        canvas.drawRect(bgRect, paint)
        // 恢复画笔原有属性
        paint.color = originColor

        // 绘制文字内容
        canvas.drawText(text!!, start, end, x, y, paint)
    }
}

使用方式：将原有设置系统Span的代码替换为自定义Span即可：

// 替换原有spannableString.setSpan(BackgroundColorSpan(color), 0, text.length, ...)
spannableString.setSpan(
    TextBackgroundSpan(ContextCompat.getColor(context, R.color.your_background_color)),
    0, 
    text.length, 
    Spannable.SPAN_EXCLUSIVE_EXCLUSIVE
)

方案优势：

• 背景边界完全由文字真实字形高度决定，无论配置多大的lineSpacingExtra、行间距倍率，都不会出现多余的内边距
• 支持通过构造函数自定义背景的垂直内边距，还可轻松扩展圆角背景、描边等自定义效果
• 跨行场景下的行为和系统Span保持一致，不会出现背景穿透行边界的问题

方案2：临时规避行间距的背景影响 #

如果不想修改原有Span逻辑，可暂时将XML中配置的android:lineSpacingExtra移除，改为通过自定义LineHeightSpan逐行控制行高，让行布局回调传入的边界值和文字真实高度保持一致。但这种方式需要额外处理多行文本的行高计算，复杂度较高，不推荐作为长期方案。

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