如何在Jetpack Compose应用中全局禁用软键盘？

针对你在带物理按键的小屏设备上开发Jetpack Compose应用、需要彻底禁用软键盘的需求，以下是几种经验证的有效方案：

1. Android平台级全局拦截（最彻底） #

在MainActivity中重写onCreateInputConnection方法，返回null直接阻止系统创建输入连接——这是软键盘唤起的核心前提，从根源上杜绝软键盘弹出，同时不影响TextField的光标调整、文本选择等操作：

class MainActivity : ComponentActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContent {
            // 你的应用根Composable
        }
    }

    override fun onCreateInputConnection(outAttrs: EditorInfo?): InputConnection? {
        // 返回null，切断系统与输入控件的连接，软键盘无法唤起
        return null
    }
}

2. Compose全局替换输入服务 #

替代已废弃的LocalTextInputService，使用LocalSoftwareKeyboardController在应用根节点全局提供空实例，阻止Compose触发软键盘唤起逻辑：

@Composable
fun AppRoot() {
    CompositionLocalProvider(
        LocalSoftwareKeyboardController provides null
    ) {
        // 嵌套你的整个应用UI
    }
}

3. 自定义无软键盘的TextField组件（局部/全局复用） #

如果需要针对特定TextField控制，或作为全局统一输入组件封装，可通过modifier.interceptKeyInput和键盘参数配置彻底禁用软键盘触发：

@Composable
fun NoSoftKeyboardTextField(
    value: String,
    onValueChange: (String) -> Unit,
    modifier: Modifier = Modifier,
    placeholder: @Composable (() -> Unit)? = null,
    // 按需添加其他TextField参数
) {
    TextField(
        value = value,
        onValueChange = onValueChange,
        modifier = modifier.interceptKeyInput { false },
        keyboardOptions = KeyboardOptions.Default.copy(
            imeAction = ImeAction.None,
            keyboardType = KeyboardType.Text
        ),
        keyboardActions = KeyboardActions(
            onAny = { /* 空实现，阻断IME动作触发 */ }
        ),
        placeholder = placeholder
    )
}

方案说明 #

• 方案1是最彻底的全局解决方案，覆盖所有输入控件场景，不会出现点击光标时软键盘弹出的问题；
• 方案2适合纯Compose场景的全局禁用，部分复杂输入控件可能需要结合方案1强化；
• 方案3适合需要局部控制或统一输入组件样式的场景，可全局复用该组件替代原生TextField。

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