Compose UI测试概述
什么是Compose UI测试
说白了，Compose UI测试就是用来验证你的Compose界面“长什么样、怎么动”的自动化校验手段。你写了一个Button，点了能不能触发逻辑？列表滑到底有没有加载更多？都是UI测试要管的事。
和传统View体系的UI测试不一样，Compose的UI是函数式的——它不直接操作“View实例”，而是通过语义树（Semantics Tree）去定位元素。我刚开始接触时也纳闷：为什么不用findViewById那种方式？后来才发现，语义树的抽象让测试更稳定，重构UI不轻易崩测试。
关键区别：Compose UI测试不依赖布局文件层级，而是基于每个组件描述的语义属性来查找节点。这意味着你的UI实现改了（比如换了一个布局容器），只要语义不变，测试代码基本不用改。
为什么需要测试
你可能觉得“手点两下不就行了”？太天真了。我在一个中型项目里遇到过这种事：改了一个列表项的Modifier.padding，结果另一个页面的卡片间距全歪了——因为那个卡片复用了同一个组件。光靠人工回归，五个页面就得点十分钟。后来补了UI测试，每次提交自动跑一遍，再没出过这种低级事故。
总结下来，测试的价值主要在三点：
- 防止回归——改动一处UI，保证其他地方不出问题
- 快速反馈——改了代码立刻知道对错，不用等QA测试
- 文档作用——测试代码本身就是“可执行的交互文档”，新同事看测试就知道页面怎么用
我个人的原则：凡是有交互行为的组件、有状态变化的界面，都必须有UI测试覆盖。纯静态展示的页面可以酌情降低覆盖率。
测试金字塔
先看一张经典的结构图，明白各层测试的定位：
这个金字塔的核心理念——越底层的测试越轻量、运行越快；越往上越贴近真实用户操作，但代价也越大。拿Compose来说：
| 层次 | 测试内容 | 典型API | 运行速度 |
|---|---|---|---|
| 单元测试 | 单个 Composable 函数渲染是否正确 | ComposeTestRule.setContent | 毫秒级 |
| 集成测试 | 多个组件组合后的交互、状态流转 | onNode(hasText(...)) performClick() | 秒级 |
| 端到端测试 | 完整的使用流程（导航+网络+数据） | ComposeTestRule + 模拟环境 | 分钟级 |
注意：不要为了追求“全覆盖”而把所有的测试都堆到端到端层。我见过一个项目，写了二百多个端到端用例，每次跑半小时……后来重构为单元+集成，十分钟跑完，问题覆盖率反而更高。
测试类型概览
Compose原生提供了一套完整的测试框架，你不需要额外引入第三方库（除了JUnit）。常用测试类型包括：
- ComposeTestRule：核心规则，每个UI测试需要它来启动Compose环境
- 语义节点匹配：通过
onNodeWithText、onNodeWithContentDescription、onNode(hasClickAction())等定位元素 - 执行动作：
performClick()、performScrollTo()、performTextInput()等模拟用户操作 - 断言：
.assertExists()、.assertTextEquals()、.assert(isEnabled())等检查状态
下面是一个最简单的测试例子，感受一下：
class CounterTest {
@get:Rule
val composeTestRule = createComposeRule()
@Test
fun counterIncrementsWhenButtonClicked() {
composeTestRule.setContent {
var count by remember { mutableStateOf(0) }
Button(onClick = { count++ }) {
Text("Clicked $count times")
}
}
// 先在屏幕找到"Clicked 0 times"的文字
composeTestRule.onNodeWithText("Clicked 0 times")
.assertExists()
// 模拟点击按钮
composeTestRule.onNodeWithText("Clicked 0 times")
.performClick()
// 断言文字更新
composeTestRule.onNodeWithText("Clicked 1 times")
.assertExists()
}
}
我个人习惯：写UI测试前，先用手工走一遍交互流程，把每个步骤写进测试，再补上边界条件（空列表、加载失败等）。这样既能保证测试覆盖了真实路径，又不会漏掉关键场景。
从这张图到示例代码，你应该已经大致理解了Compose UI测试是什么、为什么值得投入时间、以及大致有哪些测试类型。接下来每一章，我们都会深入这些知识点，一步一步学会编写健壮的Compose UI测试。