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

React Native:应用不再显示在模拟器中如何解决?

解决React Native项目在iOS模拟器不显示的问题

先拆解下你遇到的几个核心问题,咱们一步步来解决:

为什么打开AppName.xcodeproj会报错?

因为你的React Native项目用了CocoaPods管理第三方依赖,xcodeproj文件并没有包含Pods的配置信息,所以链接器才会找不到对应的库。划重点:必须始终打开AppName.xcworkspace来进行Xcode构建,这是解决后续问题的前提。

具体解决步骤:

1. 彻底清理项目与模拟器缓存

先把所有相关进程和缓存清干净,避免残留问题:

  • 关闭Xcode和所有模拟器窗口
  • 在项目根目录执行以下命令清理RN相关缓存:
    watchman watch-del-all
    rm -rf node_modules
    npm install # 用yarn的话就执行 yarn install
    rm -rf $TMPDIR/react-*
    rm -rf ios/build
    cd ios && pod deintegrate && pod install && cd ..
    
  • 打开模拟器,再次通过Hardware > Erase All Content and Settings抹掉一次内容,确保模拟器环境完全干净

2. 重新运行项目

方式一:通过React Native命令行

在项目根目录执行:

react-native run-ios

这个命令会自动打开模拟器并完成应用安装,只要之前的清理到位,应用应该能正常显示在模拟器里。

方式二:通过Xcode(必须用xcworkspace)

  • 打开AppName.xcworkspace,绝对不要碰xcodeproj文件
  • 在Xcode顶部工具栏选择正确的模拟器(比如iPhone 15)
  • 点击左上角的运行按钮(▶️),如果构建成功,模拟器会自动打开并加载应用。要是模拟器没自动弹出,你可以手动打开模拟器后,再在Xcode里重新点击运行。

3. 极端情况:手动安装应用到模拟器

如果上面的方法都不行,试试手动安装:

  • 先通过Xcode构建项目,构建产物会在ios/build/Build/Products/Debug-iphonesimulator目录下,找到你的.app文件
  • 打开模拟器,直接把这个.app文件拖到模拟器窗口里,模拟器会自动完成安装

额外提示

  • 永远记住:用CocoaPods的React Native iOS项目,必须打开xcworkspace才能正常构建
  • 以后遇到Pods相关的报错,优先执行pod deintegrate再pod install,能解决大部分依赖冲突或配置异常问题

内容的提问来源于stack exchange,提问作者Daniel

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.05.13 08:12:18