Apple Silicon设备安装CocoaPods报错，已装Ruby3.3.1仍无法解决

问题根源 #

你虽然安装了Ruby 3.3.1，但当前终端会话仍在使用系统自带的Ruby 2.6.10（Apple Silicon默认预装的旧版本），执行sudo gem install cocoapods时会触发版本不兼容错误。

解决步骤 #

1. 将新Ruby路径加入环境变量
   打开终端，编辑zsh配置文件（Apple Silicon默认shell为zsh）：

   nano ~/.zshrc
   

   在文件末尾添加一行（替换为你实际的Ruby安装路径）：

   export PATH="/Users/sampleUser/.rubies/ruby-3.3.1/bin:$PATH"
   

   按Ctrl+O保存，Ctrl+X退出编辑器。

2. 刷新环境配置
   在终端执行命令让配置立即生效：

   source ~/.zshrc
   

   也可以直接重启终端。

3. 验证Ruby版本
   执行命令确认当前使用的是Ruby 3.3.1：

   ruby -v
   

   输出应显示ruby 3.3.1。

4. 安装CocoaPods
   不要使用sudo（sudo会切换到root环境，仍调用系统旧Ruby），直接执行：

   gem install cocoapods
   

额外说明 #

如果后续打开新终端又回到旧Ruby版本，重复步骤2刷新配置即可；若问题持续，检查你的shell配置文件是否为~/.zprofile（部分场景会使用该文件），将路径添加到对应文件即可。

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