Mac安装CocoaPods执行gem命令遇权限错误，求解决方案

问题重现 #

执行命令：

Mdn@Macbook ~ % gem install activesupport -v 6.1.7.6

返回错误：

Fetching zeitwerk-2.6.11.gem
Fetching activesupport-6.1.7.6.gem
ERROR:  While executing gem ... (Gem::FilePermissionError)
    You don't have write permissions for the /Library/Ruby/Gems/2.6.0 directory.

注：提问者为电脑所有者及管理员，对权限错误存在困惑。

解决方法 #

1. 临时用sudo提升权限（快速但不推荐长期使用） #

macOS系统自带Ruby的目录受系统权限保护，即便管理员也无法直接写入，可通过sudo临时获取权限：

sudo gem install activesupport -v 6.1.7.6

执行后输入管理员密码即可完成安装。但此方式会修改系统Ruby依赖，可能引发后续兼容性问题，仅建议临时应急使用。

2. 用Ruby版本管理器搭建独立环境（推荐） #

通过rbenv或rvm安装用户级Ruby环境，彻底避开系统权限限制：

以rbenv为例：

• 先安装Homebrew（若未安装）：

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

• 安装rbenv：

brew install rbenv

• 初始化rbenv到终端配置：

rbenv init

根据提示将初始化代码添加到~/.zshrc或~/.bash_profile，重启终端生效。

• 安装指定版本Ruby：

rbenv install 2.7.8 # 选择高于2.6.0的稳定版本即可
rbenv global 2.7.8

• 再次执行gem安装命令，此时依赖会安装到用户目录，无需权限：

gem install activesupport -v 6.1.7.6

3. 直接用Homebrew安装CocoaPods（若目标是安装CocoaPods） #

如果最终目的是安装CocoaPods，无需单独处理activesupport，直接用Homebrew一键安装：

brew install cocoapods

Homebrew会自动配置所需的Ruby环境及所有依赖，完全避开权限问题。

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