Jetpack Compose中TextField的onValueChange为何频繁触发？

现象对比 #

正常运行的代码 #

val testText = remember { mutableStateOf(TextFieldValue()) }
TextField(
    value = testText.value,
    onValueChange = {
        // 仅在输入文本或移动光标时执行输出
        println("onValueChange called")
        testText.value = it.copy(
            annotatedString = buildAnnotatedString {
                append(it.text)
            },
        )
    },
)

这段代码符合预期：只有文本内容变更或用户移动光标时，才会打印onValueChange called。

出现异常的代码 #

val testText = remember { mutableStateOf(TextFieldValue()) }
TextField(
    value = testText.value,
    onValueChange = {
        // 预期仅在输入或移动光标时执行，但出现异常
        println("onValueChange called")
        testText.value = it.copy(
            annotatedString = buildAnnotatedString {
                withStyle(SpanStyle(Color.Blue)) {
                    append(it.text)
                }
            },
        )
    },
)

添加全局SpanStyle后出现异常：

• 当光标位于以字母开头的单词中间时（比如john{光标} is a person），onValueChange会持续触发，println不断输出；
• 当光标在非字母开头的内容中时（比如@john{光标} is a person或john 9{光标}9 test），表现正常。

原因分析 #

这是Jetpack Compose TextField内部的语义分词逻辑和文本状态校验机制共同导致的：

1. TextField传入onValueChange的TextFieldValue，其annotatedString包含系统自动维护的内部语义标记（比如单词边界、光标位置的上下文关联信息）。
2. 当你用buildAnnotatedString重新包裹整个文本并添加全局SpanStyle时，会完全替换原有annotatedString，丢失了这些内部标记。
3. 对于字母开头的单词，TextField的分词逻辑会持续尝试识别单词边界，但由于原有语义标记丢失，每次渲染时都会判定文本状态发生了变化，从而再次触发onValueChange，形成循环调用。
4. 而带特殊符号、数字的内容，TextField的分词逻辑不会进行频繁的边界计算，因此不会触发循环。

内容的提问来源于stack exchange，提问作者John Oberhauser