创建项目遇Ruby版本不匹配错误：本地3.0.0 vs Gemfile指定2.7.6

遇到error Your Ruby version is 3.0.0, but your Gemfile specified 2.7.6这个错误，本质是当前环境的Ruby版本和项目要求的版本不一致，下面是几种实用的解决办法：

方法1：用rbenv管理版本（推荐） #

• 先安装指定版本的Ruby：

  rbenv install 2.7.6
  

• 让当前项目目录默认使用2.7.6：

  rbenv local 2.7.6
  

• 验证版本是否切换成功：

  ruby -v
  

  输出应该显示ruby 2.7.6p147之类的内容，之后执行bundle install安装项目依赖即可。

方法2：用rvm管理版本 #

• 安装2.7.6版本：

  rvm install 2.7.6
  

• 切换到该版本：

  rvm use 2.7.6
  

• 如果想让这个版本成为全局默认，加上--default参数：

  rvm use 2.7.6 --default
  

• 验证版本后运行bundle install即可。

方法3：修改Gemfile适配当前版本（仅当确认依赖兼容时使用） #

• 打开项目根目录下的Gemfile，找到开头的ruby '2.7.6'这一行，改成ruby '3.0.0'
• 执行以下命令更新依赖包到适配3.0.0的版本：

  bundle update
  

额外提示 #

• 如果还没装rbenv或rvm，建议先安装这类Ruby版本管理工具，能避免全局版本冲突，方便在不同项目间切换版本。
• 安装指定Ruby版本时如果出现编译错误，大概率是缺少系统依赖，比如Ubuntu/Debian系统可以安装libssl-dev、libreadline-dev，Mac系统可以用Homebrew安装openssl、readline后再尝试安装。

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