在Jetpack Compose中如何避免硬编码Log的TAG标签？

方案1：轻量运行时方案（无额外依赖，适合调试场景） #

直接通过解析堆栈轨迹提取当前Composable函数名，性能开销极低，可满足绝大多数日常日志需求：

// 定义全局通用的日志工具
inline fun composeLogV(
    msg: String,
    tr: Throwable? = null,
    // 默认取调用该方法的函数名作为TAG
    tag: String = Throwable().stackTrace[1].run { 
        "$className.$methodName".substringBefore("\$") 
    }
) {
    Log.v(tag, msg, tr)
}

用法示例 #

@Composable
fun MyHomePage() {
    // 直接调用即可，自动生成TAG为 [你的包名].MyHomePage
    composeLogV("页面初始化完成")
    
    // 其他逻辑
}

@Composable
fun UserAvatar() {
    // 自动生成TAG为 [你的包名].UserAvatar
    composeLogV("加载用户头像")
}

方案2：零开销编译期方案（适合线上日志场景） #

如果需要避免运行时解析堆栈的开销，或者要兼容混淆场景，可以通过KSP（Kotlin符号处理）在编译期扫描所有@Composable注解的函数，自动生成对应TAG常量：

1. 定义标记注解（可选，也可以直接扫描所有@Composable函数）

@Target(AnnotationTarget.FUNCTION)
@Retention(AnnotationRetention.SOURCE)
annotation class ComposeLogTag

2. 编写KSP处理逻辑，遍历所有带@ComposeLogTag的函数，生成如下的常量类：

// 自动生成的代码
object ComposeTags {
    const val MyHomePage = "MyHomePage"
    const val UserAvatar = "UserAvatar"
}

3. 使用时直接调用自动生成的常量即可：

@Composable
@ComposeLogTag
fun MyHomePage() {
    Log.v(ComposeTags.MyHomePage, "页面初始化完成")
}

注意事项 #

• 运行时方案如果开启混淆，需要在ProGuard规则中保留Composable函数的方法名，否则拿到的TAG会是混淆后的乱码。
• 堆栈解析规则可以根据项目实际情况调整，过滤掉编译器生成的中间方法、系统方法即可拿到准确的函数名。

内容的提问来源于stack exchange，提问作者Luke Needham