作为一名在Android开发领域深耕多年的工程师，我见证了无数UI组件的演变。在2026年的今天，虽然我们拥有Jetpack Compose这样的声明式UI工具，但传统的View系统依然在庞大的存量应用和某些特定高性能场景中占据核心地位。
可展开的 TextView (Expandable TextView) 是一个看似简单却暗藏玄机的经典UI难题。在这篇文章中，我们将深入探讨如何实现一个功能完善、交互流畅的文本展开/折叠效果。我们不仅会编写基础代码，还会深入探讨其背后的原理、属性配置、自定义样式，以及在实际项目中的最佳实践。更重要的是，我们将结合2026年的最新开发理念，探讨如何在现代架构中优雅地处理这一需求。
为什么我们需要自定义 Expandable TextView？
虽然 Android 原生的 INLINECODE3d7d6e7b 提供了 INLINECODEd32d07e3 属性（如 end）来自动截断文本并添加省略号，但它存在一个明显的局限性：原生控件不支持用户通过点击来展开被截断的文本。用户无法看到被隐藏的内容。
为了解决这个问题，我们通常有两种方案：
- 手动实现：使用 INLINECODE480caa28 监听布局绘制，计算文本行数，动态改变 INLINECODE7ff06405。这需要编写大量样板代码且容易出错。
- 使用成熟库：利用社区封装好的库。为了让我们能更专注于业务逻辑，本文将采用经典的第三方库
com.ms-square:expandableTextView。它封装了复杂的逻辑，提供了开箱即用的平滑动画效果，并且在2026年的今天，其稳定性依然经得起考验。
项目实战：构建一个优雅的阅读界面
在构建任何组件之前，我们都需要明确上下文。我们将构建一个模拟“深度阅读器”的场景。在2026年，用户对阅读体验的要求极高，这意味着我们不仅要实现功能，还要保证极高的流畅度和可访问性。
#### 步骤 1：创建新项目与环境配置
打开 Android Studio (我们可以说是 Hedgehog 或最新版本) 并创建一个新项目。选择 “Empty Views Activity” 模板。虽然 Kotlin 已经成为主流，但为了保持该库演示的最大兼容性，我们在本节核心演示中沿用 Java，并会在后续章节讨论如何在现代 Kotlin 项目中通过 Wrapper 封装它。
#### 步骤 2：配置项目依赖与资源
2.1 添加依赖库
打开 Gradle Scripts -> build.gradle (Module: app) 文件。请注意，2026年的项目结构可能已经完全迁移至 Catalog 版本管理，但为了直观性，我们展示传统的依赖添加方式：
dependencies {
// 核心扩展库
implementation ‘com.ms-square:expandableTextView:0.1.4‘
// 2026标准实践：引入协同库以支持现代并发编程（后续章节示例会用到）
implementation ‘org.jetbrains.kotlinx:kotlinx-coroutines-android:1.9.0‘
}
点击 “Sync Now” 按钮，等待 Gradle 同步完成。
2.2 定义颜色主题与语义化
在2026年，设计不仅仅是好看，更关乎“语义”。打开 app -> res -> values -> colors.xml，定义一组符合 Material You 逻辑的颜色：
#0F9D58
#0F9D58
#05af9b
#FFFFFF
#121212
2.3 准备测试数据
为了让测试更加真实，我们需要一段能够触发“状态溢出”的文本。打开 app -> res -> values -> strings.xml：
Expandable Text Demo
[长文本内容...]
我们十分重视用户的隐私保护。本隐私声明适用于我们向您提供的所有相关服务。
当您使用我们的服务时，我们可能会收集和使用您的相关信息。我们希望通过本隐私声明
向您说明，在使用我们的服务时，我们如何收集、使用、储存和分享这些信息。
...（此处省略500字，确保触发折叠）...
我们保留随时更新本隐私声明的权利。当我们更新本隐私声明时，我们会以适当的方式
通知您（例如，通过电子邮件或在我们的网站上发布通知），并说明生效日期。
继续使用我们的服务，即表示您接受经修订的本隐私声明。
#### 步骤 3：设计用户界面 (UI)
这是实现的关键。我们将使用 INLINECODE456227c7 作为根布局，并引入 INLINECODE2765b5ff 组件。这个组件本质上是一个容器，它内部管理着一个用于显示文本的 INLINECODE3e685bb8 和一个用于触发展开/折叠动作的 INLINECODE16c580ae。
打开 app -> res -> layout -> activity_main.xml。请注意代码中的注释，它们详细解释了每个配置的意图。
<RelativeLayout
xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:expandableTextView="http://schemas.android.com/apk/res-auto"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:padding="16dp"
tools:context=".MainActivity">
<com.ms.square.android.expandabletextview.ExpandableTextView
android:id="@+id/expand_text_view"
android:layout_width="match_parent"
android:layout_height="wrap_content"
expandableTextView:animDuration="200"
expandableTextView:maxCollapsedLines="3">
#### 步骤 4：编写 Java 逻辑代码
现在，让我们将数据注入到视图中。这个步骤展示了该库的易用性——它极大地封装了 ViewTreeObserver 的复杂性。
打开 MainActivity.java，编写如下代码：
package com.example.expandabletextview;
import android.os.Bundle;
import androidx.appcompat.app.AppCompatActivity;
import com.ms.square.android.expandabletextview.ExpandableTextView;
public class MainActivity extends AppCompatActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
// 1. 获取组件实例
ExpandableTextView expTv1 = findViewById(R.id.expand_text_view);
// 2. 加载长文本数据
String longText = getString(R.string.expandable_text);
// 3. 绑定数据
// 底层库会自动计算文本行数。如果超过 maxCollapsedLines，则截断并显示按钮；
// 否则，隐藏按钮。这一切都在 layout 阶段之后自动完成。
expTv1.setText(longText);
}
}
深入探索：现代工程化与进阶优化
在2026年的开发环境中，仅仅实现功能是远远不够的。我们需要关注性能、可维护性以及如何与现代开发工具链协作。
#### 5. 动态样式定制与状态管理
在产品迭代中，UI设计风格可能会随着品牌更新而变化。硬编码图标是维护的大忌。我们可以利用 Selector 来智能管理图标状态。
5.1 创建状态选择器
创建 INLINECODEc9ab640e。这不仅让代码更整洁，还能自动处理按下和展开的状态切换，无需在 Java 代码中编写繁琐的 INLINECODE1a9b0f28 逻辑。
更新 XML 布局中的 ImageButton：
android:src="@drawable/expand_button_selector"
#### 6. 现代架构下的最佳实践 (2026视角)
在当前的项目架构中，我们已经很少直接在 Activity 中操作 UI 组件了。假设我们的项目采用了 MVVM + Repository 模式，或者使用 MVI (Model-View-Intent) 架构，我们该如何优雅地集成这个组件呢？
场景：在 RecyclerView 中的高性能应用
在列表中使用 ExpandableTextView 是性能优化的深水区。如果处理不当，滑动时的 requestLayout 会导致严重的卡顿。
我们在生产环境中的解决方案：
- 禁用滚动时的动画：在 RecyclerView 滚动时，强制禁用 ExpandableTextView 的动画，以提升帧率。
- 状态保存：确保 View 的展开状态在 RecyclerView 回收时被正确保存和恢复。
以下是一个简化的 Adapter 实现思路：
// 伪代码示例：展示核心逻辑
public class ArticleAdapter extends RecyclerView.Adapter {
// ...
@Override
public void onBindViewHolder(@NonNull ViewHolder holder, int position) {
Article item = articles.get(position);
// 设置文本
holder.expandableTextView.setText(item.getContent());
// 关键优化：如果列表正在快速滚动，暂不触发展开逻辑，或禁用动画
if (isScrolling) {
holder.expandableTextView.setAnimationDuration(0);
} else {
holder.expandableTextView.setAnimationDuration(200);
}
// 恢复状态 (假设我们在 item 对象中保存了 isExpanded 状态)
if (item.isExpanded()) {
holder.expandableTextView.expand(); // 注意：部分库可能需要手动调用 expand
} else {
holder.expandableTextView.collapse();
}
}
}
AI 辅助开发提示 (2026 特性)：
在我们的团队中，我们利用 AI 编程助手（如 GitHub Copilot 或 Cursor）来生成这类重复的 Adapter 代码。当我们输入以下注释时：
// TODO: Bind ExpandableTextView with state restoration and scroll optimization
AI 能够根据我们预先定义的代码规范，自动生成上述包含性能优化的 Java/Kotlin 代码，极大地减少了样板代码的编写时间。这就是我们所说的“Vibe Coding”——让开发者专注于业务逻辑的编排，而将语法细节交给 AI。
故障排查与常见陷阱
在多年的开发实践中，我们总结了以下三个最容易导致 Bug 的细节：
- ID 强绑定陷阱：请务必再三检查内部 INLINECODEfa57547d 的 ID 是否为 INLINECODEc5217a6f。如果 ID 不匹配，库无法找到子 View，将静默失败，导致既不显示文字也不报错。
- 高度计算错误：如果在一个 INLINECODEff00d1a5 内部嵌套了 ExpandableTextView，可能会发生高度测量冲突。建议在 ScrollView 中使用 INLINECODEcee04aa2 并给 ExpandableTextView 设置明确的初始高度约束。
- 文本闪烁问题：如果网络请求返回的数据更新了 TextView，且旧文本是展开的，新文本加载后可能会瞬间变成折叠状态再展开。解决方法是：在更新文本前，先记录 INLINECODE5371e189 状态，INLINECODE1abc5a5c 后再根据状态调用 INLINECODEa3c0b207 或 INLINECODE10238683。
总结与未来展望
通过这篇文章，我们不仅重温了 Android 开发中的经典 UI 模式，还结合 2026 年的技术背景，探讨了如何以工程化的思维去实现和优化它。
关键要点回顾：
- 选择合适的工具：
com.ms-square:expandableTextView依然是一个稳健的选择。 - 注重细节：ID 的硬性要求、布局重力的设置都是成功的关键。
- 性能至上：在 RecyclerView 中务必注意动画的禁用与状态的恢复。
- 拥抱 AI：利用现代 AI 工具处理样板代码，让我们有更多精力去思考用户体验的打磨。
随着 Jetpack Compose 的普及，类似的功能实现可能会变得更加声明式和简洁（例如使用 animateContentSize modifier），但理解 View 系统背后的布局原理，依然是每一位资深 Android 工程师不可或缺的内功。希望这篇教程能让你在 Android 开发的道路上更进一步！