MacBook M1 Pro安装CocoaPods失败：Gem原生扩展构建错误

错误核心原因 #

编译器无法生成可执行文件（需安装开发工具），无法创建Makefile（缺少必要库/头文件），本质是M1架构与系统自带Ruby的兼容性问题，加上缺失Xcode开发依赖。

解决方案步骤 #

1. 安装并配置Xcode开发工具 #

首先确保安装Xcode Command Line Tools：

xcode-select --install

若已安装但仍报错，重置工具路径：

sudo xcode-select --reset

最后接受Xcode许可协议：

sudo xcodebuild -license accept

2. 方法一：指定架构编译（适配系统Ruby） #

M1芯片为arm64架构，系统默认Ruby是x86_64版本，需指定架构参数编译：

ARCHFLAGS="-arch arm64" sudo gem install cocoapods

3. 方法二：用Homebrew安装Ruby（更推荐，避免权限问题） #

系统Ruby存在权限限制和架构适配问题，用Homebrew安装独立Ruby环境更稳定：

1. 安装Homebrew（若未安装）：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. 安装Ruby：

brew install ruby

3. 将Ruby路径添加到shell配置（针对zsh用户）：

echo 'export PATH="/usr/local/opt/ruby/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

4. 直接安装CocoaPods：

gem install cocoapods

4. 验证安装成功 #

执行以下命令确认CocoaPods安装完成：

pod --version

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