安装React-Navigation后Expo应用提示缺少非必要依赖模块怎么办？

问题根源 #

@react-navigation/stack 存在两个强制对等依赖（peer dependency）：

• react-native-gesture-handler：负责实现导航的原生手势交互（如右滑返回、抽屉拉出、栈页面拖拽切换等）
• react-native-screens：负责调用移动端原生页面容器渲染导航页，降低JS线程负载，提升页面切换的流畅度和原生体验

这两个模块是栈导航正常运行的必要依赖，不是冗余组件，React Navigation从v5版本开始就将这部分能力拆分为独立模块，没有内置在核心包中，所以安装完导航核心包后需要额外安装。
在Expo环境下建议优先使用Expo官方命令安装依赖，会自动匹配你当前Expo SDK的兼容版本，避免版本冲突：
npx expo install react-native-screens react-native-gesture-handler

模块已安装仍报错的解决方案 #

1. 彻底清理缓存 #

先停止当前运行的Metro服务，执行以下命令启动项目，自动清理所有相关缓存：
npx expo start --clear
如果仍报错，手动删除项目根目录下的node_modules文件夹、package-lock.json/yarn.lock文件，再重新执行安装命令。

2. 补全入口文件配置 #

在项目入口文件（通常是App.js/App.tsx）的最顶部添加以下代码，优先级要高于所有其他导入语句：

// 必须放在所有导入的最顶部
import 'react-native-gesture-handler';
import { enableScreens } from 'react-native-screens';
enableScreens(true);

该配置可以避免模块导入优先级错误导致的解析失败问题。

3. 修复依赖版本兼容 #

如果是手动用npm/yarn安装的依赖，大概率存在版本不兼容问题，执行Expo官方修复命令即可自动对齐所有依赖的兼容版本：
npx expo install --fix

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