Android Compose：如何在TextField获焦时隐藏软键盘？

针对你的场景，以下是几个直接有效的解决方法：

方法一：设置TextField为只读（推荐） #

将TextField的readOnly设为true，这会直接阻止系统自动弹出软键盘，同时保留文本选中、点击交互的能力，完美适配自定义键盘的使用场景。

修改后的核心代码：

@OptIn(ExperimentalFoundationApi::class)
@Composable
fun Greeting(modifier: Modifier = Modifier) {
    val text = remember { mutableStateOf("") }
    val context = LocalContext.current
    Column(
        verticalArrangement = Arrangement.Center,
        horizontalAlignment = Alignment.CenterHorizontally,
        modifier = modifier.fillMaxSize()
    ) {
        TextField(
            value = text.value,
            onValueChange = { text.value = it },
            readOnly = true, // 关键配置：阻止软键盘自动弹出
            modifier = Modifier
                .combinedClickable(
                    onClick = {
                        // 可添加点击后的自定义逻辑，比如定位光标
                    },
                    onLongClick = {
                        val clipboard: ClipboardManager =
                            context.getSystemService(CLIPBOARD_SERVICE) as ClipboardManager
                        text.value = clipboard.primaryClip?.getItemAt(0)?.text.toString()
                    }
                ),
        )

        val keys = arrayOf("Q", "W", "E", "R")
        Row {
            keys.forEach {
                Button(onClick = { text.value += it }) {
                    Text(text = it, color = Color.Black)
                }
            }
        }
    }
}

方法二：通过KeyboardOptions禁用系统键盘 #

如果需要TextField保持可编辑状态（不设置readOnly），可以通过配置keyboardOptions阻止软键盘弹出，同时在获取焦点时主动隐藏：

@OptIn(ExperimentalFoundationApi::class)
@Composable
fun Greeting(modifier: Modifier = Modifier) {
    val text = remember { mutableStateOf("") }
    val keyboardController = LocalSoftwareKeyboardController.current
    val context = LocalContext.current
    Column(
        verticalArrangement = Arrangement.Center,
        horizontalAlignment = Alignment.CenterHorizontally,
        modifier = modifier.fillMaxSize()
    ) {
        TextField(
            value = text.value,
            onValueChange = { text.value = it },
            keyboardOptions = KeyboardOptions.Default.copy(
                imeAction = ImeAction.None,
                keyboardType = KeyboardType.Text
            ),
            keyboardActions = KeyboardActions(onDone = {}), // 空实现避免默认行为
            modifier = Modifier
                .combinedClickable(
                    onClick = { keyboardController?.hide() },
                    onLongClick = {
                        val clipboard: ClipboardManager =
                            context.getSystemService(CLIPBOARD_SERVICE) as ClipboardManager
                        text.value = clipboard.primaryClip?.getItemAt(0)?.text.toString()
                        keyboardController?.hide()
                    }
                )
                .onFocusChanged {
                    if (it.isFocused) keyboardController?.hide()
                },
        )

        val keys = arrayOf("Q", "W", "E", "R")
        Row {
            keys.forEach {
                Button(onClick = { text.value += it }) {
                    Text(text = it, color = Color.Black)
                }
            }
        }
    }
}

方法三：全局禁用当前页面软键盘 #

在Activity的onCreate中配置，彻底阻止当前页面弹出系统软键盘：

class MainActivity : ComponentActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        enableEdgeToEdge()
        // 全局隐藏当前页面的系统软键盘
        window.setSoftInputMode(WindowManager.LayoutParams.SOFT_INPUT_STATE_ALWAYS_HIDDEN)
        setContent {
            CustomKeyboardTheme {
                Scaffold(modifier = Modifier.fillMaxSize()) { innerPadding ->
                    Greeting(modifier = Modifier.padding(innerPadding))
                }
            }
        }
    }
}

关键说明 #

• 方法一最适配你的自定义键盘场景：既保留TextField的交互能力（选中、长按），又彻底避免软键盘弹出。
• 不要使用focusManager.clearFocus()，这会让TextField失去焦点，破坏用户的正常交互体验。

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