You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

新建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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.05.20 10:38:01