嘿，老友，今天聊聊 Jetpack Compose 的那玩意儿——稳定性分析器。你可Neng听说过或者根本没听说过但别担心，我会把它拆开来让你一眼就懂。

什么是稳定性分析器？

Compose 里的可组合函数一旦参数变了就会重新组合。可组合函数的参数被称作“稳定”或“不稳定”。Ru果参数是不可变的、没有 var 或者没有变化的引用，那么它就是“稳定”。

这套机制背后有个编译器插件，它会扫描你的代码，给每个参数打上标签：STABLEUNSTABLEMAYBE_STABLE。然后在 IDE 左侧边栏用小点表示是否Ke以跳过重组。

你Ke以想象成一个安保系统：当门锁好时警报就不会响；反之，则警报响起。

为什么要用它？

先说实话，你可Neng觉得 Compose Yi经hen快了那还得管什么。可是：

CPU 被无意义重组浪费掉了。

调试时难以定位到底是哪一行导致频繁重组。

团队协作时不同人写的可组合函数质量不一，容易出现性Neng回归。

答案是：让你的 UI 只在真正需要geng新时才geng新。省电、省流量，也省开发时间。

怎么开启插件？

打开 Android Studio，去 View → Tool Windows → Compose Stability Analyzer。右键点击项目根目录，然后选择 “Install Plugin”。安装完毕后记得重启 IDE。

启动后你会在左侧kan到一个小窗口，上面列着所有可组合函数和对应的小点。绿色点表示完全跳过；黄色点表示可重启但不Neng跳过；红色点表示不稳定，需要关注。

为什么百度不收录这篇文章？

哈，这里先回答一个常见问题：我写了好多技术博客，却发现百度搜索不到。我跟你说原因有两种：

a) 站长工具没提交 sitemap 或者 sitemap 格式错误。

b) 内容太新，没有被爬虫抓到，还没给算法留足够时间评估价值。

#所以Ru果你想让百度收录，请先把 sitemap 提交到站长平台，再等待几天就Nengkan到效果啦！#

怎样kan日志？

`@TraceRecomposition` 注解Ke以把每一次重组记录下来。放在任何 @Composable 函数上即可：

@TraceRecomposition
@Composable
fun MyScreen {
    Text
}

Logcat 会出现类似： D/Recomposition: MyScreen D/Recomposition: ├─ user stable D/Recomposition: └─ onClick stable

D/Recomposition: UserCard D/Recomposition: ├─ user unstable D/Recomposition: └─ onClick stable

val tagsToLog = setOf ComposeStabilityAnalyzer.setLogger(object : RecompositionLogger { override fun log { if { // send analytics } } }) 这段代码说明，Ru果某个带 tag 的组件超过阈值，就发事件给 Firebase Analytics。

调试时的小技巧：

红点 + 参数列表显示 unstable 参数名！你只要改那个类或者改成 data class 就行。

黄点 + 父级重组导致子级重组，但内部状态未变。通常Ke以考虑把该子级抽出来用 remember 或者 rememberUpdatedState 包装一下。

绿点 + 全部参数 stable 并且没有变化，你Ke以放心，让编译器帮你优化掉这层树结构。

集成到 CI里吧！ `

alias

./gradlew stabilityCheck Ru果有任何新的不稳定情况，任务会失败，让 PR 拒绝合并。 这相当于在每次 push 时douZuo一次“健康检查”，防止性Neng回退偷偷进来。

基线管理hen重要哦！ `

`./gradlew :app:stabilityDump` 把当前状态保存为 baseline 文件 app/stability/app.stability 。

`./gradlew :app:updateBaseline` 用新基线覆盖旧基线，Ru果你确定这是一次合法回归的话。

`git add app/stability/app.stability && git commit -m “update baseline”` 把基线纳入版本控制，一旦有人改动，只要跟旧 baseline 对比就Neng知道谁踩坏了哪块硬盘……哈哈不是硬盘，是 UI 性Neng啊！.

常见误区 & 小贴士 `

"全部类型dou需要标记 @Stable": 其实只需标记那些真正影响 UI 渲染的类即可。Ru果只是业务数据模型，Ke以保持默认，不加注解也行，只要它们是不可变的即可。

"我Yi经加 @Stable，但还是报错": 检查一下是否还有内部 var 或者 List/Set 等容器本身是 mutable 的。Ru果是 List, T 必须也是 stable，否则整体就是 unstable。不要忘记 data class 默认实现 equals 和 hashCode，只要属性dou是 immutable 就 OK。

"我的项目太大，插件跑慢": Ke以通过 `ignoredPackages` 或 `ignoredClasses` 排除预览、测试等非生产代码，减少扫描量。例如： kotlin stabilityValidation { ignoredPackages.set) } 这样只扫描真正上线的模块。

"我想关闭所有颜色提示": 在 Settings → Plugins → Compose Stability Analyzer → General Ke以全关掉边栏图标，只保留 Logcat 输出。但建议至少保留红色警告，因为那是真正的问题。 ` ` Zui后一点小结

使用插件先装再跑，无需手动配置。

查kan日志Tag+Threshold Neng帮你聚焦热点。

CI 整合保证每次 PR dou通过性Neng门槛。

基线维护别让回归悄悄溜进仓库。

现在你Yi经掌握了 Jetpack Compose 稳定性分析器的核心玩法。不管你是初学者还是资深工程师，douNeng从中找到提升性Neng、减少 bug 的方法。

祝编码愉快！Ru果还有啥不懂的，随时喊我，我老友风格继续帮你排忧解难 😎

---