Jetpack Compose 如何让 TextField 默认获得焦点但不弹出键盘？

可以使用基于 TextFieldState 的输入框，将 KeyboardOptions.showKeyboardOnFocus 设为 false，再通过 FocusRequester 请求焦点。输入框会获得焦点并显示光标，软键盘则等用户点击输入框时才出现。

原代码使用的是 TextFieldValue 和 onValueChange 重载，直接添加这个参数不会生效。该选项适用于基于 TextFieldState 的输入框，旧式重载会忽略它。KeyboardOptions API 说明

使用支持该选项的输入框

下面用基于 TextFieldState 的 BasicTextField 演示完整实现。项目中的 Compose Foundation 依赖需要提供这些 API。

import androidx.compose.foundation.layout.fillMaxWidth
import androidx.compose.foundation.text.BasicTextField
import androidx.compose.foundation.text.KeyboardOptions
import androidx.compose.foundation.text.input.rememberTextFieldState
import androidx.compose.runtime.Composable
import androidx.compose.runtime.LaunchedEffect
import androidx.compose.runtime.remember
import androidx.compose.ui.Modifier
import androidx.compose.ui.focus.FocusRequester
import androidx.compose.ui.focus.focusRequester

@Composable
fun ChatMessageInput() {
    val messageState = rememberTextFieldState()
    val focusRequester = remember { FocusRequester() }

    BasicTextField(
        state = messageState,
        modifier = Modifier
            .fillMaxWidth()
            .focusRequester(focusRequester),
        keyboardOptions = KeyboardOptions(
            showKeyboardOnFocus = false
        )
    )

    LaunchedEffect(Unit) {
        focusRequester.requestFocus()
    }
}

焦点和键盘显示分别由以下配置控制：

• FocusRequester.requestFocus() 让输入框获得焦点。
• showKeyboardOnFocus = false 阻止程序请求焦点时自动显示软键盘，用户点击输入框时仍可打开键盘。参数行为说明

LaunchedEffect(Unit) 会在组件进入 Composition 时执行，普通重组不会反复请求焦点。不要直接在 Composable 函数体中调用 requestFocus()，以免重组时重复抢占焦点。

原有状态代码如何调整

原来的 msg.value 和 onValueChange 由 TextFieldState 接管。发送消息时，可以读取：

val message = messageState.text.toString()

BasicTextField 提供基础编辑能力。如果需要原来 Material TextField 的外观，可以在项目依赖支持的情况下使用其基于 TextFieldState 的重载，并保留相同的焦点和键盘配置。

需要注意的边界

showKeyboardOnFocus = false 控制的是获得焦点时是否自动显示键盘。如果进入聊天页面之前键盘已经打开，该设置不会主动隐藏它。

也不建议优先采用“先请求焦点，再调用 keyboardController.hide()”的方式。这需要协调输入会话与隐藏请求的时机，可能出现键盘短暂弹出或隐藏请求未生效的情况。

如果项目无法识别示例中的 API，应先检查 Compose Foundation 依赖及组件重载。不要用 enabled = false 代替键盘控制，这会同时禁用输入；readOnly = true 则会改变编辑行为，无法直接满足聊天输入框的需求。

备注：内容仅供参考。