M1芯片Mac安装CocoaPods报错求助（架构不兼容+Ruby环境问题）

核心问题分析 #

报错显示bigdecimal.bundle为arm64架构，但系统调用的x86_64环境无法兼容，且系统默认使用自带Ruby而非rbenv管理的Ruby，导致架构不匹配。

解决方案步骤 #

1. 确保rbenv管理的Ruby生效 #

• 编辑你的shell配置文件（zsh用户为~/.zshrc，bash用户为~/.bash_profile），添加rbenv初始化代码：

  eval "$(rbenv init - zsh)"
  

• 重启终端或执行以下命令使配置生效：

  source ~/.zshrc
  

• 验证Ruby路径，确认指向rbenv的shims目录：

  which ruby
  # 输出应为 ~/.rbenv/shims/ruby 而非 /usr/bin/ruby
  

2. 安装兼容arm64的Ruby版本 #

• 安装CocoaPods支持的Ruby版本（推荐3.2.2）：

  rbenv install 3.2.2
  

• 设置为全局默认Ruby：

  rbenv global 3.2.2
  

• 确认版本：

  ruby -v
  

3. 清理旧gem并重装CocoaPods #

• 卸载系统自带的CocoaPods及冲突的bigdecimal gem：

  sudo gem uninstall cocoapods
  sudo gem uninstall bigdecimal
  

• 使用rbenv的Ruby安装CocoaPods：

  gem install cocoapods
  pod setup
  

• 验证安装并测试：

  pod --version
  cd 你的项目目录
  pod install
  

临时替代方案（无需修改Ruby环境） #

如果不想调整Ruby环境，可通过Rosetta兼容x86_64架构：

• 找到「终端」应用，右键选择「显示简介」，勾选「使用Rosetta打开」
• 重启终端后，重新执行pod install

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