Ruby 版本管理器
在 Linux 或 macOS 上安装 Ruby 的最最受欢迎的方法是使用版本管理器,例如, RVM 或 rbenv。 版本管理器允许您在计算机上安装多个 Ruby 版本,并在它们之间快速切换。 RubyMine 会自动检测安装在本地计算机上的解释器,并由以下版本管理器维护:
您可以切换 Ruby 解释器(以及 RVM 和 rbenv 的 gemset),此操作适用于现有项目的 Ruby 解释器 页面,并且可以在 创建新项目时选择所需的解释器。
自动建议的 Ruby 解释器/宝石集
版本管理器支持用于切换项目的 Ruby 版本和 gemset 的各种类型的配置文件。 例如,您可以通过以下方式之一将 Ruby 解释器版本设置为 2.6.3 ,并将 gemset 设置为 sample_rails_app:
使用 .ruby-version / .ruby-gemset 文件
ruby-2.6.3sample_rails_app使用该 .versions.conf 文件
ruby=2.6.3 ruby-gemset=sample_rails_app
版本要求与已配置解释器
在确定和应用 Ruby 版本时,这些来源发挥不同作用:
- 已配置的 Ruby 解释器
在 页面上配置的解释器是该模块的活动解释器。 这是在 RubyMine 中唯一生效的解释器 — 它运行代码、解析 gem,并提供代码洞察。
- 版本管理器文件
诸如 .ruby-version 、 .ruby-gemset 、 .rvmrc 、 .rbenv-gemsets 、 .rbenv-version 、 .tool-versions 和 .versions.conf 等文件会声明所需版本。 RubyMine 读取这些要求以确定所需的 Ruby 版本。 版本管理器文件优先于 Gemfile 或 gems.rb 。
- Gemfile 和 gems.rb
Gemfile 或 gems.rb 文件中的
ruby指令声明所需的 Ruby 版本或版本约束。 支持的格式包括精确版本(例如ruby "3.3.1")、最小或最大边界(例如ruby ">= 3.1.0")以及悲观版本约束(例如ruby "~> 3.3")。 仅当没有版本管理器文件指定版本时,RubyMine 才会查阅 Gemfile 或 gems.rb 。
如果项目的 Ruby 模块的解释器设置不匹配,RubyMine 会显示通知:
如果 RubyMine 检测到您的机器上安装了所需的 Ruby 版本,它将建议将其设置为当前项目的解释器。 点击通知中的按钮进行切换。

仅适用于 Linux/macOS:如果未找到所需的 Ruby 版本,并且您使用 rbenv、 RVM 或 asdf ,RubyMine 将建议 使用您的版本管理器安装该版本。

远程 Ruby 解释器
RubyMine 允许您使用通过版本管理器维护的 远程 Ruby 解释器。 在这种情况下,配置远程解释器时,您必须指定版本管理器可执行文件的路径。 例如,下表列出了 Linux 的典型路径。
版本管理器 | 可执行文件路径 |
|---|---|
RVM | 单用户模式: /home/jetbrains/.rvm/bin/rvm (针对 jetbrains 用户) 多用户模式: /usr/local/rvm/bin/rvm 混合模式: /usr/share/rvm/bin/rvm |
rbenv | /home/jetbrains/.rbenv/bin/rbenv (对于 jetbrains用户) /usr/bin/rbenv |
chruby | /usr/local/share/chruby/chruby.sh |
asdf | /home/jetbrains/.asdf/bin/asdf (对于 jetbrains用户) |
Mise | /home/jetbrains/.local/bin/mise (对于 jetbrains用户) |
调试 Ruby 解释器检测
如果您在检测由版本管理器维护的本地 Ruby 解释器时遇到问题,请按照以下步骤操作,以帮助我们确定问题的原因:
打开 RubyMine 并在主菜单中进入 。
在调用的对话框中,为您的版本管理器指定一个记录器标识符:
RVM:
#org.jetbrains.plugins.ruby.version.management.rvm.RvmSdkRefresherrbenv:
#org.jetbrains.plugins.ruby.version.management.rbenv.RbenvSdkRefresherchruby:
#org.jetbrains.plugins.ruby.version.management.chruby.ChrubySdkRefresherasdf:
#org.jetbrains.plugins.ruby.version.management.asdf.AsdfSdkRefresherMise:
#org.jetbrains.plugins.ruby.version.management.mise.MiseSdkRefresher

点击 确定。
重启 RubyMine。
打开 日志文件并确保其中包含与您的版本管理器对应的条目,例如:
2018-07-30 16:57:18,237 [7350] DEBUG - management.asdf.AsdfSdkRefresher - Refreshing sdks创建问题并附上日志。