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

使用React Native CLI创建项目时遇Pods安装失败及模板下载错误

React Native CLI创建项目Pod安装失败的解决方法

1. 修复权限问题(核心解决sudo依赖)

  • 确认CocoaPods的brew安装路径:执行which pod,确保输出为/usr/local/bin/pod(Intel芯片)或/opt/homebrew/bin/pod(M系列芯片)
  • 修复项目内Pods目录权限:进入项目的ios文件夹,执行sudo chown -R $(whoami) Pods/ Podfile.lock,让当前用户拥有完整操作权限
  • 全局修复CocoaPods缓存权限:sudo chown -R $(whoami) ~/.cocoapods/

2. 跳过CLI自动安装,手动初始化Pods

  • 创建项目时跳过自动安装步骤:npx react-native init MyProject --skip-install
  • 进入项目的ios目录:cd MyProject/ios
  • 手动执行Pod安装:pod install,此时可查看详细错误日志定位问题(如依赖冲突、网络超时等)
  • 若遇网络问题,切换国内镜像:
    pod repo remove master
    pod repo add master https://mirrors.tuna.tsinghua.edu.cn/git/CocoaPods/Specs.git
    pod install --verbose
    

3. 调整CocoaPods版本适配React Native

  • 部分React Native版本与高版本CocoaPods存在兼容问题,可尝试降级到稳定版本:
    brew uninstall cocoapods
    brew install cocoapods@1.12.1
    brew link cocoapods@1.12.1 --force
    

4. 清理缓存后重试

  • 清理React Native项目缓存:npx react-native clean
  • 清理CocoaPods全局缓存:pod cache clean --all
  • 重新创建项目:npx react-native init MyProject

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.07.01 23:34:58