屏幕旋转/主题切换后，如何让TextField光标移至末尾并保持键盘弹出？

问题根源 #

屏幕旋转、主题切换属于Android配置变更，此时Compose会触发页面重组。如果TextField的输入状态（文本、光标位置）未通过持久化方式保存，或者焦点逻辑处理不当，就会出现光标重置到文本开头、键盘自动收起的问题。结合你使用的Compose 1.3.0 + Material 3 1.0.0版本，以下是针对性解决方案：

解决方案：用TextFieldValue持久化完整输入状态 #

单纯保存文本字符串无法保留光标位置，需要使用TextFieldValue存储包含文本、光标/选择范围的完整状态，再通过SavedStateHandle实现配置变更后的状态恢复。

步骤1：创建可序列化的状态包装类

TextFieldValue本身不可序列化，需自定义包装类实现序列化：

@Serializable
data class SavedTextFieldState(
    val text: String,
    val selectionStart: Int,
    val selectionEnd: Int
)

// 扩展函数实现状态互转
fun TextFieldValue.toSavedState() = SavedTextFieldState(
    text = text,
    selectionStart = selection.start,
    selectionEnd = selection.end
)

fun SavedTextFieldState.toTextFieldValue() = TextFieldValue(
    text = text,
    selection = TextRange(selectionStart, selectionEnd)
)

步骤2：在ViewModel中管理持久化状态

通过SavedStateHandle存储和恢复输入状态：

class SearchBookViewModel(savedStateHandle: SavedStateHandle) : ViewModel() {
    // 从SavedStateHandle获取持久化的搜索状态，默认空输入
    private val _searchState = savedStateHandle.getStateFlow(
        key = "search_state",
        initialValue = SavedTextFieldState("", 0, 0)
    ).map { it.toTextFieldValue() }
    
    val searchState = _searchState.asStateFlow()

    // 更新搜索状态时同步保存到SavedStateHandle
    fun onSearchStateChanged(newState: TextFieldValue) {
        savedStateHandle["search_state"] = newState.toSavedState()
    }
}

步骤3：在Screen中正确绑定状态与焦点

控制仅首次加载时请求焦点，避免重组时重复触发；同时处理键盘自动弹出逻辑：

@Composable
fun SearchBookScreen(viewModel: SearchBookViewModel = viewModel()) {
    val searchState by viewModel.searchState.collectAsState()
    val focusRequester = remember { FocusRequester() }
    val isFirstLaunch = remember { mutableStateOf(true) }
    val context = LocalContext.current

    // 首次加载时请求焦点
    LaunchedEffect(isFirstLaunch.value) {
        if (isFirstLaunch.value) {
            focusRequester.requestFocus()
            isFirstLaunch.value = false
        }
    }

    // 配置变更后，若文本非空则强制弹出键盘
    LaunchedEffect(Unit) {
        snapshotFlow { searchState.text.isNotEmpty() }
            .filter { it && !isFirstLaunch.value }
            .collect {
                val imm = context.getSystemService(Context.INPUT_METHOD_SERVICE) as InputMethodManager
                imm.toggleSoftInput(InputMethodManager.SHOW_FORCED, 0)
            }
    }

    TextField(
        value = searchState,
        onValueChange = viewModel::onSearchStateChanged,
        modifier = Modifier.focusRequester(focusRequester),
        keyboardOptions = KeyboardOptions.Default.copy(imeAction = ImeAction.Search),
        placeholder = { Text("搜索书籍") }
        // 其他自定义配置
    )
}

关键说明 #

1. SavedStateHandle的作用：自动处理配置变更时的状态持久化，无需手动处理onSaveInstanceState。
2. TextFieldValue的必要性：相比单纯的String，它能完整保存光标位置和文本选择范围，避免光标错位。
3. 焦点控制逻辑：通过isFirstLaunch标记仅首次加载时请求焦点，防止重组时重复触发导致异常。

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