安装React-Native时Ruby版本不匹配且rbenv切换失效怎么解决？

一、修复rbenv Ruby版本切换失效 #

• 检查rbenv的shell配置：
  1. 终端执行 echo $PATH，确认输出中~/.rbenv/shims和~/.rbenv/bin位于系统Ruby路径（如/usr/bin）之前。
  2. 若未配置，根据你使用的shell编辑对应配置文件：
     • bash：编辑~/.bash_profile或~/.bashrc，添加：

       export PATH="$HOME/.rbenv/bin:$PATH"
       eval "$(rbenv init -)"
       

     • zsh：编辑~/.zshrc，添加上述内容。
  3. 执行source ~/.zshrc（对应你的shell文件）或重启终端，使配置生效。
• 验证rbenv有效性：执行which ruby，输出应为~/.rbenv/shims/ruby，而非系统默认路径。
• 确认Ruby 2.7.5已安装：执行rbenv versions，若未列出，运行rbenv install 2.7.5完成安装。
• 重新切换版本：执行rbenv global 2.7.5（全局生效）或在项目目录执行rbenv local 2.7.5（仅当前项目），再用ruby -v确认版本切换成功。

二、解决Bundler安装失败 #

• 切换到正确Ruby版本后，安装兼容的Bundler：gem install bundler:2.3.26（版本可匹配项目Gemfile.lock中的指定版本）。
• 进入React Native项目根目录，执行bundle install完成依赖安装。

三、配置iOS环境 #

• 安装并打开最新稳定版Xcode，同意协议并完成组件安装。
• 安装CocoaPods：执行brew install cocoapods（或sudo gem install cocoapods）。
• 进入项目的ios目录，运行pod install完成iOS依赖配置。

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