无法安装CocoaPods：构建Gem原生扩展失败求助

报错原因 #

报错核心是ffi-1.16.3 gem编译原生扩展时找不到ffi.h头文件，通常是系统缺少libffi依赖库，或是使用macOS自带Ruby时的权限/环境限制导致。

解决方案 #

方法1：安装libffi并指定环境变量 #

• 通过Homebrew安装libffi依赖：

  brew install libffi
  

• 设置环境变量让Ruby能定位到libffi的头文件和库：

  export LDFLAGS="-L$(brew --prefix libffi)/lib"
  export CPPFLAGS="-I$(brew --prefix libffi)/include"
  

• 单独安装指定版本的ffi gem：

  gem install ffi -v 1.16.3
  

  若提示权限问题，优先考虑用下面的Ruby版本管理方案；若必须使用系统Ruby，可临时加sudo执行。
• 最后安装CocoaPods：

  gem install cocoapods
  

方法2：用Ruby版本管理工具（推荐） #

macOS自带Ruby版本老旧且权限限制多，用rbenv管理独立Ruby环境更稳定：

• 安装rbenv：

  brew install rbenv
  

• 初始化rbenv（根据终端类型选择配置命令）：

  rbenv init
  # zsh终端执行
  echo 'eval "$(rbenv init - zsh)"' >> ~/.zshrc
  # bash终端执行
  echo 'eval "$(rbenv init - bash)"' >> ~/.bashrc
  

• 重启终端后，安装一个较新的Ruby版本（例如3.2.2）：

  rbenv install 3.2.2
  

• 设置全局使用该Ruby版本：

  rbenv global 3.2.2
  

• 直接安装CocoaPods：

  gem install cocoapods
  

方法3：直接用Homebrew安装CocoaPods（最简单） #

跳过gem安装流程，直接通过Homebrew完成安装：

brew install cocoapods

注意事项 #

• 避免频繁使用sudo gem install，会修改系统Ruby目录，引发后续权限问题。
• 若用Homebrew安装，后续更新CocoaPods只需执行brew upgrade cocoapods。

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