React Native执行yarn ios启动iOS项目RCT-Folly编译失败如何解决?
问题产生原因
- 项目路径包含特殊字符/空格:你当前项目路径
/Users/gift/Desktop/personal projects/gainerDemo中存在空格,Xcode编译C++类依赖(如RCT-Folly)时,对带空格的路径解析会出现异常,导致编译失败 - 缓存损坏:Xcode的DerivedData缓存、CocoaPods本地缓存、node_modules依赖缓存存在损坏,引发编译错误
- 版本不兼容:Xcode版本和当前React Native版本依赖的RCT-Folly版本存在兼容性问题,尤其是Xcode 14+搭配0.68以下版本的RN时,会出现C++编译语法不兼容问题
- Xcode配置异常:未正确配置Command Line Tools,或是M系列芯片Mac未做适配,引发编译架构不匹配问题
解决方法
按优先级尝试以下方案:
- 修正项目路径:把路径中的空格全部替换为下划线或直接删除,例如将
personal projects改为personal_projects,修改路径后直接尝试重新构建 - 全量清理缓存并重新安装依赖:
依次执行以下命令:
执行完成后再运行# 清理Xcode缓存 rm -rf ~/Library/Developer/Xcode/DerivedData/* # 清理iOS侧依赖缓存 cd ios rm -rf Pods Podfile.lock pod deintegrate pod cache clean --all # 清理JS侧依赖缓存 cd .. rm -rf node_modules yarn.lock # 重新安装依赖 yarn install cd ios && pod install --repo-updateyarn ios尝试启动 - 适配Xcode版本兼容规则:如果使用Xcode 14及以上版本、且RN版本低于0.68,可以在Podfile的
post_install代码块中添加如下配置:
保存文件后重新执行post_install do |installer| installer.pods_project.targets.each do |target| if target.name == 'RCT-Folly' target.build_configurations.each do |config| config.build_settings['GCC_PREPROCESSOR_DEFINITIONS'] ||= ['$(inherited)', '_LIBCPP_ENABLE_CXX17_REMOVED_UNARY_BINARY_FUNCTION'] end end end endpod install再进行构建 - 修正Xcode配置:打开Xcode偏好设置 → 位置选项卡,确认Command Line Tools选择的是当前使用的Xcode版本,而非旧版本或空值;如果使用M系列芯片Mac,可以尝试将终端切换为Rosetta模式后再执行构建命令
内容的提问来源于stack exchange,提问作者David Odinaka Enyoghasim
相关产品推荐
相关产品推荐

