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

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-update
    
    执行完成后再运行yarn 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
    end
    
    保存文件后重新执行pod install再进行构建
  • 修正Xcode配置:打开Xcode偏好设置 → 位置选项卡,确认Command Line Tools选择的是当前使用的Xcode版本,而非旧版本或空值;如果使用M系列芯片Mac,可以尝试将终端切换为Rosetta模式后再执行构建命令

内容的提问来源于stack exchange,提问作者David Odinaka Enyoghasim

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.09.26 17:45:04