Compose性能优化与卡顿排查实战 - 第4节 🔎 Layout Inspector

🔍 性能优化不是玄学 —— 使用 Layout Inspector 观察布局层级，借助 Recomposition Counts 发现冗余重组，通过 Compose Compiler Metrics 量化编译期稳定性。三位一体，告别卡顿。

🔎 Layout Inspector

实时查看 Composable 树与布局边界
测量每个节点的测量/布局耗时
识别过度绘制 & 深层嵌套
支持 3D 视图 & 属性面板

// 启动方式 (Android Studio)
View → Tool Windows → Layout Inspector
或直接点击右下角 Layout Inspector 标签

🔁 Recomposition Counts

显示每个 Composable 的重组次数
开启方式：开发者选项 → 显示更新
配合 Modifier.layout 定位异常重组
识别不稳定输入导致的冗余重组

// 全局开启重组计数
// 在 AndroidManifest 中:
<application
  android:debuggable="true" ...>
// 或运行时 adb shell setprop debug.compose.recomposition-counts true

📐 Compose Compiler Metrics 编译期稳定性报告

📋 关键指标

稳定性 · 类/参数是否为 stable
重启/跳过 · 可跳过重组次数
Lambda 稳定性 · 捕获参数是否稳定
@Stable 标记建议

// 启用 Compiler Metrics (build.gradle)
composeOptions {
    kotlinCompilerExtensionVersion = "1.5.10"
}
// 添加编译参数
kotlinOptions {
    freeCompilerArgs += [
        "-P",
        "plugin:androidx.compose.compiler.plugins.kotlin:metricsDestination=" +
        project.buildDir.absolutePath + "/compose-metrics"
    ]
}

指标	说明	优化方向
restartable	可重启重组	减少不稳定参数
skippable	可跳过重组	✅ 理想状态
stable	参数/类稳定	使用 immutable / @Stable
lambda	lambda 稳定性	避免捕获可变状态
knownStable	已知稳定	善用不可变集合

💡 示例输出片段 (ComposeCompilerMetrics):

com.example.MyComposable:
  restartable: ✅ skippable: ✅ stable: ✅
  lambda: stable (捕获参数均为稳定类型)

📌 实战排查步骤

打开 Layout Inspector 检查嵌套深度
开启 Recomposition Counts 观察高频重组
分析 Compiler Metrics 报告不稳定类
使用 @Stable / immutable 修复
验证重组计数下降 & 帧率提升

🧪 代码示例：标记稳定

@Stable
data class UserProfile(
    val name: String,
    val avatarUrl: String,
    val age: Int
)

@Composable
fun ProfileCard(profile: UserProfile) {
    // 由于 UserProfile 是 stable，输入不变时重组可跳过
    Text(profile.name)
}

⚡ 重组计数与性能分析工具 Layout Inspector · Recomposition Counts · Compiler Metrics

🔎 Layout Inspector

🔁 Recomposition Counts

📋 关键指标

📌 实战排查步骤

🧪 代码示例：标记稳定