Mac执行pod update不生效且报Ruby错误（已升级Ruby至最新版）的修复咨询

问题背景 #

我在Mac设备上执行pod update操作时出现Ruby报错，目前已经将Ruby升级至最新版本，需要对应的问题修复方案。

触发报错时执行的终端命令：
pod update

实操修复步骤 #

• 校验当前终端生效的Ruby版本：执行ruby -v查看输出结果，若显示版本为Mac系统自带的2.6.x版本，说明之前的Ruby升级未同步到当前终端环境，需重新配置Homebrew安装的Ruby到环境变量的优先级列表，让新安装的Ruby覆盖系统默认版本。
• 重装匹配版本的CocoaPods：Ruby版本升级后，旧版本CocoaPods和新Ruby的API不兼容是高频报错原因，执行gem install cocoapods -n /usr/local/bin完成重装，再通过pod --version确认安装正常。
• 规避gem权限拦截：若执行gem相关命令时返回权限类Ruby报错，不要直接加sudo强行提权安装，需在用户目录下的shell配置文件（~/.zshrc或~/.bash_profile）中添加自定义gem安装路径的环境变量，让gem的安装目录指向用户可写的路径，避免写入系统目录触发拦截。
• 同步项目本地Ruby依赖：若项目通过Gemfile管理版本依赖，直接执行pod update会和本地锁定的依赖版本冲突，需先执行bundle install同步本地依赖，再通过bundle exec pod update执行更新操作，解决依赖版本不一致的报错。

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