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

创建React Native项目时遇CocoaPods依赖安装错误求助

解决React Native项目初始化时CocoaPods依赖安装失败问题

第一步:清理残留文件

先彻底删除创建失败的MyProject目录,回到干净的父目录操作,避免残留的vendor文件夹触发多Podfile警告。

第二步:验证并修复iOS环境依赖

  1. 检查Xcode状态:确保Xcode是最新稳定版,且首次打开时已完成初始化(同意许可协议、安装必要组件)。
  2. 排查Ruby环境权限:系统自带Ruby容易出现权限问题,执行which ruby,如果输出是/usr/bin/ruby,建议用rbenv或rvm重新安装管理Ruby 2.6.10。
  3. 重装CocoaPods:
    # 先卸载现有版本
    sudo gem uninstall cocoapods
    # 重新安装指定版本
    gem install cocoapods -v 1.12.1
    # 同步pod仓库
    pod setup
    
    若用brew安装的CocoaPods,替换为brew uninstall cocoapods && brew install cocoapods@1.12.1。

第三步:手动控制依赖安装流程

执行初始化时跳过自动安装,后续手动处理:

npx react-native@latest init MyProject --skip-install

进入项目iOS目录手动安装pod依赖:

cd MyProject/ios
pod install --repo-update

若仍报错,清理pod缓存后重试:

rm Podfile.lock
rm -rf Pods
pod install --repo-update

第四步:调整Yarn版本兼容

Yarn 3.x(Berry)与React Native初始化可能存在兼容问题,临时切换到Yarn 1.x:

yarn set version classic

完成初始化和依赖安装后,可按需切换回Yarn 3.x。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.07.24 14:52:48