执行EAS iOS本地生产构建时遇Cocoapods不可用错误求助

1. 确认Cocoapods是否已安装 #

运行以下命令检查：

pod --version

如果提示“command not found”，按芯片类型安装：

• Intel芯片：用RubyGems安装

  sudo gem install cocoapods
  

• M1/M2芯片：优先用Homebrew安装（避免架构兼容问题）

  brew install cocoapods
  

2. 检查并修复PATH环境变量 #

Cocoapods的执行路径需要在系统PATH中：

• 先查看当前PATH：

  echo $PATH
  

• 对比Cocoapods的实际路径：
  • RubyGems安装的路径通常是/usr/local/bin或~/.gem/ruby/<你的Ruby版本>/bin
  • Homebrew安装的路径（M系列）是/opt/homebrew/bin，Intel是/usr/local/bin
• 如果路径不在PATH里，编辑你的shell配置文件（比如~/.zshrc或~/.bash_profile），添加：

  # 替换成你的Cocoapods实际路径
  export PATH="$PATH:/opt/homebrew/bin"
  

• 生效配置：

  source ~/.zshrc
  

3. 避免用sudo执行EAS构建 #

sudo会切换到root用户，其PATH环境变量和普通用户不一致，大概率找不到pod命令。直接运行构建命令：

eas build -p ios --profile production --local

如果遇到权限错误，修复项目目录权限：

sudo chown -R $(whoami) /path/to/your/project

4. 验证修复 #

重新打开终端，运行pod --version确认能正常输出版本号，再执行EAS构建命令即可。

内容的提问来源于stack exchange，提问作者Maksim Fedyanin