新建React Native项目执行react-native run-ios编译报错求助
兄弟,太懂你刚建完React Native项目就踩坑的郁闷了!用react-native init test创建项目后直接跑react-native run-ios出错,大概率是漏了这些关键前置操作,我给你一一捋清楚:
常见遗漏的关键步骤
- 确认macOS系统版本达标:React Native开发iOS应用要求macOS至少是10.15(Catalina)版本,系统版本太低的话很多原生依赖跑不起来。先去「关于本机」看看你的系统版本,不够的话得先升级。
- Xcode必须装全组件:
- 首先得在App Store装最新版的Xcode,装完一定要打开一次Xcode——它会弹出协议确认和额外组件安装的提示,必须等这步完成才能继续,很多人会直接跳过打开Xcode这步,直接跑命令肯定报错。
- 还要配置Xcode命令行工具:终端执行
xcode-select --install,如果提示已安装就跳过,没装的话跟着引导完成安装。
- 别忘了装CocoaPods依赖:iOS项目的原生依赖全靠CocoaPods管理,你进入test目录后,得先执行
cd ios && pod install && cd ..,等pod依赖全部安装完成后,再去跑react-native run-ios。这步是新手最容易漏的,直接跑命令肯定会因为缺少依赖报错。 - 检查Node.js和Watchman:React Native对Node.js版本有要求(建议用16.x或18.x的LTS版本),Watchman是监听文件变化的工具,必须安装。终端执行
node -v和watchman version检查,如果没装Watchman,用Homebrew装:brew install watchman。 - 缓存问题试试重置:如果上面的步骤都做了还是报错,大概率是缓存搞的鬼。执行
npm start -- --reset-cache清空缓存,然后重新运行react-native run-ios。
内容的提问来源于stack exchange,提问作者r4id4
相关产品推荐
相关产品推荐

