已安装GestureHandler仍报错：NativeViewGestureHandler需为GestureHandlerRootView子组件

• 已通过npx expo install react-native-gesture-handler安装GestureHandler
• 在App.tsx文件第3行引入了import 'react-native-gesture-handler';（包含polyfills）
• 严格遵循Expo v48文档步骤操作，执行npx expo start --clear清除缓存后，仍出现以下报错：

Error: NativeViewGestureHandler must be used as a descendant of GestureHandlerRootView.
Otherwise the gestures will not be recognized.
See https://docs.swmansion.com/react-native-gesture-handler/docs/installation for more details.

解决方案 #

• 用GestureHandlerRootView包裹根组件
  从react-native-gesture-handler导入该组件，然后把整个应用的内容放在它内部，示例代码：

// 把这行移到最顶部，确保是第一个导入
import 'react-native-gesture-handler';
import { GestureHandlerRootView } from 'react-native-gesture-handler';
import { View, Text } from 'react-native';

export default function App() {
  return (
    <GestureHandlerRootView style={{ flex: 1 }}>
      {/* 这里放你的应用所有内容，比如导航容器、页面组件等 */}
      <View>
        <Text>你的应用内容</Text>
      </View>
    </GestureHandlerRootView>
  );
}

• 调整导入顺序：import 'react-native-gesture-handler';必须是App.tsx的第一个导入语句，不能放在第3行，移到最顶部才能确保polyfill正确加载

• 再次清除缓存重启项目：

npx expo start --clear

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