React Native Android：如何避免键盘弹出/收起时破坏视图布局？

下面是几种能解决键盘弹出破坏布局问题的实用方法，按优先级推荐：

1. 修改AndroidManifest.xml的软键盘模式 #

这是最直接的系统级配置，能从根源阻止布局被调整。

• 找到项目中的 android/app/src/main/AndroidManifest.xml 文件
• 找到对应主Activity的标签，添加或修改 android:windowSoftInputMode 属性为 adjustNothing：

<activity
    android:name=".MainActivity"
    android:label="@string/app_name"
    android:configChanges="keyboard|keyboardHidden|orientation|screenLayout|screenSize|smallestScreenSize|uiMode"
    android:launchMode="singleTask"
    android:windowSoftInputMode="adjustNothing" <!-- 关键配置 -->
    android:exported="true">
</activity>

adjustNothing 会让系统完全不调整布局，键盘弹出时直接覆盖在现有视图上方，完全保留原设计的布局结构。

2. 配合KeyboardAvoidingView锁定布局 #

如果不想修改系统配置，也可以用React Native自带的KeyboardAvoidingView组件，通过设置特定参数让布局不偏移：

import { KeyboardAvoidingView, Platform } from 'react-native';

// 在你的根容器外层包裹
<KeyboardAvoidingView
  behavior={Platform.OS === 'ios' ? 'padding' : 'height'}
  style={{ flex: 1 }}
>
  {/* 你的原有布局 */}
</KeyboardAvoidingView>

Android平台下设置behavior="height"，组件会通过调整自身高度来适配键盘，但不会移动内部视图的位置，保证原有布局结构不变。

3. 手动监听键盘状态控制布局 #

如果以上方法都不适用，可以通过监听键盘的显示/隐藏事件，手动固定容器的尺寸：

import { Keyboard, View, Dimensions } from 'react-native';
import { useEffect, useState } from 'react';

function YourComponent() {
  const [keyboardVisible, setKeyboardVisible] = useState(false);

  useEffect(() => {
    const showSubscription = Keyboard.addListener('keyboardDidShow', () => {
      setKeyboardVisible(true);
    });
    const hideSubscription = Keyboard.addListener('keyboardDidHide', () => {
      setKeyboardVisible(false);
    });

    return () => {
      showSubscription.remove();
      hideSubscription.remove();
    };
  }, []);

  return (
    <View
      style={{
        flex: 1,
        // 键盘弹出时固定容器高度，避免被拉伸
        height: keyboardVisible ? Dimensions.get('window').height : '100%'
      }}
    >
      {/* 你的原有布局 */}
    </View>
  );
}

这种方式灵活性最高，适合有特殊布局需求的场景。

注意事项 #

• 如果你的布局中使用了ScrollView，需要确保scrollEnabled属性在键盘弹出时设置为false，避免用户误滑动破坏布局。
• 不同版本的React Native可能对软键盘模式的处理有细微差异，建议测试时覆盖不同Android版本的设备。

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