本地执行EAS Build构建iOS项目时提示Cocoapods不可用问题

核心问题 #

你已安装Cocoapods，但EAS Build本地构建进程未读取到当前shell的PATH配置，导致无法找到pod命令。

解决步骤 #

1. 确认Cocoapods的安装路径 #

先执行命令定位pod的实际位置：

which pod

输出示例：/usr/local/bin/pod、~/.rbenv/shims/pod（rbenv用户）或~/.rvm/gems/ruby-x.x.x/bin/pod（rvm用户）。

2. 临时指定路径执行构建 #

在构建命令中手动注入pod的路径，临时解决问题：

PATH="$PATH:$(dirname $(which pod))" eas build --profile development --platform ios --local

也可以直接写死查到的路径，比如：

PATH="$PATH:/usr/local/bin" eas build --profile development --platform ios --local

3. 永久配置PATH环境变量 #

如果临时方法有效但不想每次重复输入，修改shell配置文件（根据你用的shell选择~/.zshrc或~/.bash_profile）：

• 打开配置文件：

open ~/.zshrc

• 添加路径配置（替换为你查到的pod所在目录）：

export PATH="/usr/local/bin:$PATH"

• 让配置立即生效：

source ~/.zshrc

重启终端后再执行构建命令。

4. 适配Ruby版本管理器（rbenv/rvm用户） #

若通过Ruby版本管理器安装Cocoapods，需确保EAS能读取到对应环境：

• rbenv用户执行：

rbenv global <你的Ruby版本号>
echo 'eval "$(rbenv init - zsh)"' >> ~/.zshrc

• rvm用户执行：

rvm use default --default
echo 'source "$HOME/.rvm/scripts/rvm"' >> ~/.zshrc

重启终端后重试构建。

5. 验证EAS能否找到pod #

执行以下命令测试EAS进程的pod路径识别：

npx eas-cli which pod

输出路径则说明配置生效，可正常执行构建。

内容的提问来源于stack exchange，提问作者Nishant Narayan Rout