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

iOS环境安装CocoaPods报错:Failed to build gem native extension

解决CocoaPods重新安装时的Ruby头文件缺失问题

嘿,这个问题我之前帮不少开发者解决过——本质是Ruby编译原生扩展时找不到必要的头文件,大多是因为Xcode Command Line Tools没装好或者没完成初始化配置,下面给你一步步来搞定:

第一步:安装/更新Xcode Command Line Tools

打开终端,敲下面的命令:

xcode-select --install

如果弹出提示说“command line tools are already installed”,那就直接跳到第二步。

第二步:确认Xcode许可协议已同意

有时候哪怕装了工具,没同意苹果的许可协议也会搞出问题,运行这条命令:

sudo xcodebuild -license accept

输入你的系统密码就行(输入的时候终端不会显示字符,正常输完回车就好)。

第三步:重新尝试安装CocoaPods

现在再跑安装命令试试:

sudo gem install cocoapods

如果还是不行?试试用Homebrew绕开系统Ruby的坑

系统自带的Ruby版本往往比较老,权限问题也多,换用Homebrew安装的Ruby会更省心:

  1. 先装Homebrew(没装过的话):
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  1. 用Homebrew装Ruby:
brew install ruby
  1. 把Homebrew的Ruby路径加到环境变量里(重启终端才会生效):
# 如果你用的是zsh(现在Mac默认是这个)
echo 'export PATH="/usr/local/opt/ruby/bin:$PATH"' >> ~/.zshrc
# 要是用的是bash,就改成 ~/.bash_profile
  1. 重启终端后,直接装CocoaPods(这次不用加sudo了):
gem install cocoapods

额外提一句

错误里那些Ignoring bigdecimal-xxx的提示不用太慌,等头文件问题解决后,你可以跑gem pristine bigdecimal --all来修复这些gem的扩展,但先把CocoaPods装上优先~

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.05.14 08:02:15