运行React Native项目时出现报错该如何解决？

你遇到的是Metro打包器模块解析失败类错误，按以下步骤逐一排查即可解决：

• 优先清理缓存解决脏数据问题，这是这类报错最高频的诱因，在项目根目录执行对应命令：

  # 重置Metro打包缓存
  npm start -- --reset-cache
  # yarn 用户替换为 yarn start --reset-cache
  # pnpm 用户替换为 pnpm start -- --reset-cache
  
  # 安卓端额外清理原生构建缓存
  cd android && ./gradlew clean && cd ..
  # iOS端额外清理原生构建缓存
  cd ios && xcodebuild clean && cd ..
  

• 核对入口文件配置
  确认项目根目录存在入口文件index.js（0.49之前的旧版本RN对应为index.android.js、index.ios.js），同时检查package.json内的main字段配置和实际入口路径一致，标准配置为：

  {
    "main": "index.js"
  }
  

• 重装依赖排除依赖缺失问题
  依赖安装不全、软链异常也会触发这类解析错误，执行命令重装即可：

  # 删除现有依赖和锁文件
  rm -rf node_modules package-lock.json yarn.lock pnpm-lock.yaml
  # 重新安装依赖
  npm install
  # 对应用户使用的包管理器执行安装即可
  

• 检查路径拼写
  如果报错是在调整文件位置、新增引用后出现，核对所有import/require语句的相对路径层级、文件名大小写，Metro打包对路径大小写敏感，本地文件系统不区分大小写不代表打包阶段可以识别错误拼写的路径。

若你使用的是0.72及以上版本RN，额外检查metro.config.js中的watchFolders配置，确保项目根目录在监听范围内，没有被误加入排除列表。

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