如何在 Android TextView 中动态加粗部分文本

本文介绍使用 SpannableString 实现 TextView 中动态、精准加粗指定片段文本的完整方案，解决 HTML 标签在 String Resource 中无法被 HtmlCompat.fromHtml() 正确解析样式的问题。

本文介绍使用 spannablestring 实现 textview 中动态、精准加粗指定片段文本的完整方案，解决 html 标签在 string resource 中无法被 `htmlcompat.fromhtml()` 正确解析样式的问题。

在 Android 开发中，若需对 TextView 的文本进行局部样式定制（如仅加粗某一部分），直接依赖 等 HTML 标签配合 HtmlCompat.fromHtml() 往往失效——尤其当字符串模板来自 strings.xml 且占位符内容动态生成时。根本原因在于：HtmlCompat.fromHtml() 仅解析字符串字面量中的 HTML 标签，而 String.format() 会先完成插值，导致 标签被当作普通文本拼入，最终失去语义与样式能力。

✅ 推荐方案：使用 SpannableString 手动控制样式范围，实现类型安全、运行时可控、兼容性高的局部富文本渲染。

Android 开发者指南 第一部分：入门

Android文档-开发者指南-第一部分：入门-中英文对照版 Android提供了丰富的应用程序框架，它允许您在Java语言环境中构建移动设备的创新应用程序和游戏。在左侧导航中列出的文档提供了有关如何使用Android的各种API来构建应用程序的详细信息。第一部分：Introduction(入门) 0、Introduction to Android(引进到Android) 1、Application Fundamentals(应用程序基础) 2、Device Compatibility(设备兼容性) 3、

下载

✅ 步骤详解（Kotlin 示例）

1. 拆分字符串资源（避免 HTML 解析依赖）
   将含 HTML 标签的原始字符串拆为三段，确保可计算加粗区域起止索引：

   <!-- res/values/strings.xml -->
   <string name="this_is_base_note_prefix">This is base note of group </string>
   <string name="this_is_base_note_suffix">. It cannot be deleted individually but with the rest of the group.</string>

2. 构建完整文本并定位加粗区间
   动态获取待加粗内容（注意空值处理），拼接前后缀，并精确计算加粗起始与结束位置：

   val prefix = getString(R.string.this_is_base_note_prefix)
   val suffix = getString(R.string.this_is_base_note_suffix)
   val boldText = db.getGroupTitleByExtNoteOrder(
       noteItemList[getAdapterPosition()].noteOrder
   )?.let { " $it" } ?: ""
   
   val fullText = prefix + boldText + suffix

3. 应用 StyleSpan 到指定区间
   创建 SpannableString，使用 Spannable.SPAN_EXCLUSIVE_EXCLUSIVE 保证样式不随文本修改意外扩散：

   val spannable = SpannableString(fullText)
   val start = prefix.length
   val end = start + boldText.length
   spannable.setSpan(
       StyleSpan(Typeface.BOLD),
       start,
       end,
       Spannable.SPAN_EXCLUSIVE_EXCLUSIVE
   )
   textView.text = spannable

⚠️ 关键注意事项

• 索引计算必须严格：prefix.length 是字符数（非字节数），确保 boldText 未被额外 trim 或转义；若 boldText 含 Unicode 组合字符（如表情符号），建议用 codePointCount() 进一步校验（但本场景通常无需）。
• 避免重复 Span：若多次调用该逻辑（如 RecyclerView ViewHolder 复用），每次应新建 SpannableString，防止旧 Span 残留干扰。
• 兼容性保障：SpannableString 在 API 1+ 全版本可用，无需额外兼容处理；StyleSpan(Typeface.BOLD) 比 android.graphics.Typeface.BOLD 更推荐（后者在旧版可能 fallback 异常）。
• 进阶扩展：如需同时支持斜体、颜色、点击事件等，可链式调用 setSpan() 添加多个 Span（如 ForegroundColorSpan、ClickableSpan），各 Span 可重叠或独立作用。

✅ 总结

SpannableString 是 Android 原生富文本控制的基石方案，相比 HTML 解析更可靠、更灵活、更易调试。当面对动态内容 + 局部样式需求时，主动放弃 HtmlCompat.fromHtml() 的“快捷路径”，转而采用可编程的 Span 控制，是写出健壮 UI 代码的关键实践。