2026 Android 开发进阶指南：深入掌握 TextView 下划线与富文本排版

欢迎回到我们的 Android UI 开发进阶指南。在 2026 年的今天，应用界面的精致程度已成为决定用户体验的关键因素。在日常的开发中，我们经常需要通过文本样式的微调来传达特定的 UI 语义，例如强调关键条款、标记促销价格，或者仅仅是为了在视觉上突出某些重要信息。

INLINECODEcf4f8dcd 作为 Android 生态中最基础且无可替代的 UI 组件，虽然功能极其强大，但令人惊讶的是，它默认并不提供直接在 XML 属性中为文本添加下划线的简单开关（如 INLINECODE8e156f3b）。这往往会给初学者，甚至是从 Web 平台迁移过来的资深开发者带来一些困扰。你可能会问：“为什么我不能像 CSS 那样直接在布局文件里设置 text-decoration: underline 呢？”

实际上，这是由于 Android 在设计之初采用了灵活且强大的文本样式系统——Spannable。在本文中，我们不仅会展示如何实现这一功能，还会深入探讨其背后的渲染原理，以及如何在 2026 年结合现代开发理念和 AI 辅助工具，写出更加健壮、可维护且高性能的代码。我们将主要使用 Kotlin 语言进行演示，因为它不仅简洁，而且是如今 Android 开发的首选语言。

核心概念：为什么不能用 XML 直接设置？

在我们动手写代码之前，让我们先理解一下“为什么”。在 Android 的早期版本中，XML 布局主要关注视图的结构，而复杂的样式渲染则留给 Java/Kotlin 代码或 Spannable 系统来处理。这种设计模式虽然在初期增加了学习曲线，但在处理复杂的富文本排版时展现出了惊人的灵活性。

虽然我们可以通过 textView.getPaint().setUnderlineText(true) 这种“暴力”方法给整个 TextView 的内容添加下划线，但这通常不是我们想要的效果——我们通常只想给特定的某个词或句子添加样式，或者是实现自定义颜色、粗细的下划线。为了实现细粒度的控制，我们需要使用 Android 提供的 Spannable API。

方法一：使用 SpannableString 进行编程式下划线

这是最常用、最灵活的方法。通过 SpannableString，我们可以将字符串的不同部分与不同的样式（即“Span”）绑定。在 2026 年的今天，虽然 Jetpack Compose 已占据半壁江山，但在传统的 View 系统中，掌握 Span 依然是处理复杂文本的核心技能。

#### 实战演练：代码解析

让我们通过一个完整的例子来看看具体怎么做。我们将创建一个新项目，并在屏幕中央显示一段带有下划线的文本。

步骤 1：创建布局文件

首先，我们需要在 INLINECODEd755802f 中定义我们的 INLINECODEd664203d。为了简单起见，我们使用 ConstraintLayout 来将文本居中。

步骤 2：实现 MainActivity.kt 逻辑

接下来是核心部分。我们需要在 Activity 中获取这个 TextView，并使用 UnderlineSpan 来处理文本。

package org.geeksforgeeks.underlinetext

import androidx.appcompat.app.AppCompatActivity
import android.os.Bundle
import android.graphics.Typeface
import android.text.SpannableString
import android.text.Spanned
import android.text.style.UnderlineSpan
import android.widget.TextView

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        // 1. 找到我们在 XML 中定义的 TextView
        val mTextView = findViewById(R.id.text_view_1)

        // 2. 定义原始文本内容
        val mString = "Hello Geek!"
      
        // 3. 创建一个 SpannableString 对象
        // SpannableString 允许我们对文本中的特定范围应用样式
        val mSpannableString = SpannableString(mString)
        
        // 4. 创建 UnderlineSpan 对象
        // 这个 Span 定义了下划线的样式
        val underlineSpan = UnderlineSpan()
        
        // 5. 将 Span 应用到 SpannableString
        // 参数说明：
        // underlineSpan: 要应用的样式
        // 0: 样式开始位置的索引（包含）
        // mSpannableString.length: 样式结束位置的索引（不包含）
        // Spanned.SPAN_EXCLUSIVE_EXCLUSIVE: Span 标志位，表示插入文本不会扩展这个 Span
        mSpannableString.setSpan(underlineSpan, 0, mSpannableString.length, Spanned.SPAN_EXCLUSIVE_EXCLUSIVE)

        // 6. 将处理好的文本设置给 TextView
        mTextView.text = mSpannableString
    }
}

代码深度解析：

请注意 INLINECODE6765b506 方法中的标志位 INLINECODEdbf35111。这是一个非常专业的细节。它定义了当我们在文本中间插入新字符时，这个下划线样式会如何变化。EXCLUSIVE_EXCLUSIVE 意味着如果我们在头部或尾部插入文字，下划线不会自动扩展到新文字上。这在处理动态文本时非常重要，能防止样式“泄漏”到不想被影响的文字上。

2026 前沿视角：构建可复用的文本扩展与 Compose 互操作

随着我们步入 2026 年，Android 开发已经高度 Kotlin化。作为追求极致的开发者，我们不应该在每次需要下划线时都写一堆样板代码。我们可以利用 Kotlin 的 扩展函数 来封装这些逻辑，使代码更加整洁。此外，如果你的项目正在逐渐迁移到 Jetpack Compose，我们也需要考虑如何在两种体系间共存或迁移。

#### Kotlin 扩展函数最佳实践

我们可以创建一个名为 TextViewExtensions.kt 的文件，将常用的文本处理逻辑封装起来。这不仅符合现代 Android 开发的最佳实践，也方便了单元测试。

import android.content.Context
import android.text.SpannableString
import android.text.Spanned
import android.text.style.UnderlineSpan
import android.widget.TextView
import androidx.core.content.res.ResourcesCompat

/**
 * 扩展函数：为 TextView 的部分文本添加下划线
 * @param target 需要加下划线的子字符串
 */
fun TextView.underlineText(target: String) {
    val text = this.text.toString()
    if (!text.contains(target)) return

    val spannableString = SpannableString(text)
    val startIndex = text.indexOf(target)
    val endIndex = startIndex + target.length

    // 应用 UnderlineSpan
    spannableString.setSpan(
        UnderlineSpan(),
        startIndex,
        endIndex,
        Spanned.SPAN_EXCLUSIVE_EXCLUSIVE
    )

    this.text = spannableString
}

/**
 * 扩展函数：为 TextView 的全部文本添加下划线
 * 这种方式比 Paint Flags 更灵活，因为它可以与其他 Span 结合使用
 */
fun TextView.underlineAll() {
    val spannableString = SpannableString(this.text)
    spannableString.setSpan(
        UnderlineSpan(),
        0,
        spannableString.length,
        Spanned.SPAN_EXCLUSIVE_EXCLUSIVE
    )
    this.text = spannableString
}

现在，在你的 Activity 或 Fragment 中，你只需要一行代码：

// 在 Activity 中调用
val mTextView = findViewById(R.id.text_view_1)
mTextView.text = "点击这里领取优惠券"
mTextView.underlineText("这里")

#### 进阶：自定义颜色的下划线

这是一个非常高频的进阶需求。默认的 INLINECODE0a3e415f 强制下划线颜色与文本颜色一致。但在 2026 年的品牌定制化设计中，我们经常遇到“黑色文字配红色下划线”来强调价格或警告的场景。标准的 API 无法直接实现这一点，我们需要自定义一个 INLINECODE8ff7e0cc。

虽然这有点复杂，但这是企业级开发中的标准操作。

import android.graphics.Canvas
import android.graphics.Paint
import android.text.style.LineBackgroundSpan


class ColoredUnderlineSpan(private val color: Int) : LineBackgroundSpan {
    override fun drawBackground(
        canvas: Canvas, 
        paint: Paint, 
        left: Int, 
        right: Int, 
        top: Int, 
        baseline: Int, 
        bottom: Int,
        text: CharSequence, 
        start: Int, 
        end: Int, 
        lnNum: Int
    ) {
        // 保存原始颜色
        val originalColor = paint.color
        
        // 设置我们想要的下划线颜色
        paint.color = color
        
        // 绘制下划线
        // 这里的 y 坐标计算是关键，我们将其定位在 baseline 下方
        canvas.drawLine(left.toFloat(), (baseline + 6).toFloat(), right.toFloat(), (baseline + 6).toFloat(), paint)
        
        // 恢复原始颜色
        paint.color = originalColor
    }
}

AI 辅助开发提示：当你需要编写这种涉及 Canvas 坐标计算的代码时，建议使用 AI 编程工具（如 Cursor）生成初始框架，然后手动微调 baseline + 6 这类魔法数值，以确保在不同字号和屏幕密度下对齐完美。

2026 技术深度：AI 驱动开发与现代架构融合

在 2026 年的开发流程中，编写代码只是工作的一部分。我们更多地是在与 AI 结对编程，并关注代码的可维护性和架构的演进。让我们看看如何将上述技术融入到更现代的工作流中。

#### Agentic AI 与 Cursor 的实战应用

你可能已经注意到，编写复杂的 Span 逻辑容易出错。我们可以利用 Agentic AI 工具来加速这一过程。例如，在 Cursor 或 Windsurf 等 AI IDE 中，我们可以直接输入自然语言指令：“

> "为 TextView 创建一个扩展函数，给价格为 ‘99.9‘ 的文本添加红色下划线，并确保它兼容 RecyclerView 的复用机制。"

AI 不仅会生成 INLINECODE91b67dbc 的代码，甚至会提醒你关于 INLINECODE2a10e5a7 中 Span 复用的潜在问题。这种“氛围编程”让我们从繁琐的语法细节中解放出来，专注于业务逻辑和用户体验的打磨。

#### 架构决策：View 还是 Compose？

如果我们在 2026 年启动一个全新的电商模块，我们可能倾向于使用 Jetpack Compose。在 Compose 中，下划线的实现变得更加声明式和直观。然而，维护现有的遗留系统仍然是许多团队的核心工作。

Jetpack Compose 实现：

import androidx.compose.material.Text
import androidx.compose.ui.text.SpanStyle
import androidx.compose.ui.text.buildAnnotatedString
import androidx.compose.ui.text.style.TextDecoration
import androidx.compose.ui.graphics.Color

// 在 Composable 中
val annotatedString = buildAnnotatedString {
    append("原价：")
    withStyle(SpanStyle(textDecoration = TextDecoration.LineThrough, color = Color.Gray)) {
        append("¥999")
    }
    append("  现价：")
    withStyle(SpanStyle(textDecoration = TextDecoration.Underline, color = Color.Red, fontWeight = FontWeight.Bold)) {
        append("¥199")
    }
}

Text(text = annotatedString)

在互操作的场景下，如果你在现有的 View 系统中通过 INLINECODEdd267166 嵌入 Compose，或者在 Compose 中通过 INLINECODE6904c7bd 复用旧的 XML，理解底层的 Span 原理能帮助你做出更平滑的迁移决策。

生产环境下的性能优化与陷阱规避

在我们的实际开发经验中，处理文本样式往往会带来隐蔽的性能问题。特别是在 RecyclerView 或列表视图中，不恰当的使用 Span 会导致滚动卡顿。

#### 1. RecyclerView 中的 Span 复用策略

在列表的 INLINECODE15637f3c 中，我们绝对不应该每次绑定都创建新的 INLINECODE1b4a78fd 或 UnderlineSpan 对象。这不仅会增加 GC 压力，还会导致微小的卡顿累积成明显的掉帧。

最佳实践：

• 文本缓存：如果列表项的文本是静态的，预先在数据模型中处理好 SpannableString。
• Span 对象复用：对于相同的样式，可以定义一个全局的静态 Span 实例（如 singleton UnderlineSpan），因为 Span 本身是无状态的，它只影响绘制的样式。

object SpanCache {
    // 全局复用的 UnderlineSpan 实例
    val UNDERLINE_SPAN = UnderlineSpan()
    
    // 自定义颜色的 Span 缓存
    private val colorSpans = mutableMapOf()
    
    fun getColoredSpan(color: Int): ColoredUnderlineSpan {
        return colorSpans.getOrPut(color) { ColoredUnderlineSpan(color) }
    }
}

#### 2. 性能监控与可观测性

在 2026 年的应用架构中，可观测性是必不可少的。如果你发现界面渲染耗时过长，可以使用 Android Profiler 检查 SpannableString 的构建是否在主线程占用了过多 CPU。

对于极其复杂的文本排版，如果你的应用主打阅读体验，甚至可以考虑使用 Jetpack Compose。Compose 的 AnnotatedString 在处理大段文本重组时，往往比传统的 Span 系统性能更好，因为它利用了更细粒度的失效机制。

总结与 2026 展望

通过这篇文章，我们深入探讨了 Android 文本下划线的实现方式，从基础的 SpannableString 到 HTML 解析，再到 2026 年视角下的扩展函数封装和性能优化。

关键要点回顾：

• 不要滥用 Paint Flags：除非你想给整个 TextView 加下划线，否则请使用 SpannableString。
• 拥抱 Kotlin 扩展：将复杂的 Span 逻辑封装成扩展函数，保持调用处的简洁。
• 注意 RecyclerView 性能：避免在 bind 方法中重复创建 Span 对象，利用缓存策略。
• 考虑 Compose：对于新项目，Jetpack Compose 提供了更现代、更易于维护的文本样式管理方式（INLINECODE029ffbe3 + INLINECODEd00606ba）。

随着 AI 辅助编程的普及，虽然基础 API 的记忆不再那么重要，但理解底层原理（如渲染机制、内存模型）能让我们更好地指挥 AI 生成高质量、无 Bug 的代码。希望这篇指南能帮助你写出更优雅、更健壮的 Android 应用代码！