You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

已安装正确Ruby版本仍出现React Native项目创建版本错误

解决React Native创建时Ruby版本不生效的问题

1. 确认终端实际使用的Ruby版本

先排查终端当前加载的Ruby版本是否和rbenv设置一致:

  • 查看当前运行版本:ruby -v
  • 查看rbenv全局配置版本:rbenv global
  • 查看当前目录本地配置版本:rbenv local
    如果三者输出不一致,说明rbenv的环境变量未正确加载。

2. 验证shell配置文件的rbenv代码

根据你使用的shell(zsh或bash),检查对应配置文件中的代码是否正确:

  • zsh用户打开.zshrc,bash用户打开.bash_profile,确认以下代码存在且未被注释:
export PATH="$HOME/.rbenv/bin:$PATH"
eval "$(rbenv init -)"

注意:如果同时配置了两个文件,当前终端使用的shell只会读取对应配置,比如zsh不会加载.bash_profile的内容。

3. 手动刷新shell配置

无需重启终端,直接运行命令加载配置:

  • zsh用户:source ~/.zshrc
  • bash用户:source ~/.bash_profile
    之后再次运行ruby -v,确认版本是否切换为rbenv设置的版本。

4. 检查rbenv安装完整性

运行which rbenv,如果无输出,说明rbenv未正确安装,可重新执行安装命令:
git clone https://github.com/rbenv/rbenv.git ~/.rbenv
安装完成后重新配置环境变量并刷新shell。

5. 确保安装React Native要求的Ruby版本

React Native通常要求Ruby 2.7及以上版本,确认你安装的版本符合要求:

  • 安装指定版本:rbenv install 2.7.6
  • 设置为全局版本:rbenv global 2.7.6
    之后再次尝试创建项目:npx react-native init MyProject

6. 排查系统Ruby路径优先级

运行echo $PATH,查看$HOME/.rbenv/bin是否在系统Ruby路径(如/usr/bin)之前。如果顺序颠倒,调整配置文件中PATH的顺序,将$HOME/.rbenv/bin放在最前端。

内容的提问来源于stack exchange,提问作者Vishal Lohar

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.10 05:46:10