安装Cocoapods时出现Gem::FilePermissionError权限错误求助

针对系统Ruby权限错误的解决方案 #

方案1：用户目录安装（无需sudo） #

由于系统Ruby的目录受SIP保护，无法直接写入，可通过--user-install参数将CocoaPods安装到用户专属目录：

• 执行安装命令：

  gem install cocoapods --user-install
  

• 将用户gem的可执行文件路径添加到环境变量（Monterey默认使用zsh）：

  echo 'export PATH="$HOME/.gem/ruby/2.6.0/bin:$PATH"' >> ~/.zshrc
  

• 刷新环境变量：

  source ~/.zshrc
  

• 验证安装：

  pod --version
  

方案2：使用rbenv管理独立Ruby版本（更推荐） #

通过rbenv安装独立Ruby版本，彻底避开系统Ruby的权限限制：

• 用Homebrew安装rbenv：

  brew install rbenv
  

• 初始化rbenv：

  rbenv init
  

• 重启终端，或执行以下命令刷新配置：

  source ~/.zshrc
  

• 安装兼容CocoaPods的Ruby版本（例如2.7.6，可根据需求调整）：

  rbenv install 2.7.6
  

• 设置全局Ruby版本：

  rbenv global 2.7.6
  

• 安装CocoaPods：

  gem install cocoapods
  

修复Homebrew反复提示安装命令行工具的问题 #

• 确保Xcode命令行工具指向正确路径：

  xcode-select --switch /Applications/Xcode.app/Contents/Developer
  

• 重置Homebrew的包索引：

  brew update --force
  

• 卸载已有的CocoaPods（如果之前尝试安装过）：

  brew uninstall cocoapods
  

• 清理Homebrew缓存：

  brew cleanup
  

• 重新安装CocoaPods：

  brew install cocoapods
  

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