Expo项目导入react-navigation/native-stack提示找不到如何解决

这是Expo项目集成React Navigation时的高频共性问题，大量开发者都遇到过完全相同的报错，问题基本集中在依赖缺失、缓存残留、版本不匹配、路径拼写错误几类原因，可按以下优先级逐一排查解决：

• 补装缺失的独立依赖包
  从React Navigation v6版本开始，native-stack是独立发布的npm包，并不包含在@react-navigation/native核心包内，很多开发者跟着文档走完核心依赖安装步骤后会漏装这个包。直接在项目根目录执行对应包管理器的安装命令即可：

  • npm用户执行：npm install @react-navigation/native-stack
  • yarn用户执行：yarn add @react-navigation/native-stack
  • pnpm用户执行：pnpm add @react-navigation/native-stack
    注意包名必须带@react-navigation/前缀，漏写前缀会直接导致安装错误、模块找不到。

• 全链路清理缓存后重启服务
  装完依赖仍提示找不到模块的场景里，90%都是构建缓存未更新导致的，按以下步骤操作：

  1. 按Ctrl+C彻底终止当前正在运行的Expo开发服务，不要留后台进程
  2. 优先尝试带缓存清理参数启动项目：expo start -c
  3. 如果上述操作无效，直接删除依赖目录和锁文件重装：
     • 删除项目根目录下的node_modules文件夹
     • 删除对应包管理器的锁文件：npm对应package-lock.json、yarn对应yarn.lock、pnpm对应pnpm-lock.yaml
     • 重新执行全量依赖安装命令，再启动项目

• 校验版本兼容性
  如果你的Expo SDK版本较旧，直接安装最新版React Navigation生态包会出现版本不兼容、模块解析失败的问题。需要对照当前项目使用的Expo SDK版本，安装对应兼容区间的@react-navigation/native和@react-navigation/native-stack版本，不要跨大版本强行升级依赖。

• 检查代码导入路径拼写
  确认业务代码里的导入语句完全正确，标准导入写法为：

  import { createNativeStackNavigator } from '@react-navigation/native-stack'
  

  常见拼写错误包括：漏写包名的@前缀、把native-stack误写为stack（后者是另一个基于JS实现的栈导航包，和native-stack不是同一个模块）。

• Monorepo项目额外检查依赖提升配置
  如果你的项目是Monorepo架构，确认@react-navigation/native-stack没有被错误提升到仓库根目录的node_modules中，导致Expo构建时无法在当前项目目录下解析到模块，可以在业务项目目录下单独执行一次native-stack的安装命令，将包写入当前项目的依赖列表。

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