RubyMine 2026.3 Help

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.3
    sample_rails_app
  • 使用该 .versions.conf 文件

    ruby=2.6.3 ruby-gemset=sample_rails_app

版本要求与已配置解释器

在确定和应用 Ruby 版本时,这些来源发挥不同作用:

已配置的 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 版本,它将建议将其设置为当前项目的解释器。 点击通知中的按钮进行切换。

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

    从通知中安装 Ruby

远程 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 解释器时遇到问题,请按照以下步骤操作,以帮助我们确定问题的原因:

  1. 打开 RubyMine 并在主菜单中进入 帮助 | 诊断工具 | 调试日志设置。

  2. 在调用的对话框中,为您的版本管理器指定一个记录器标识符:

    • RVM: #org.jetbrains.plugins.ruby.version.management.rvm.RvmSdkRefresher

    • rbenv: #org.jetbrains.plugins.ruby.version.management.rbenv.RbenvSdkRefresher

    • chruby: #org.jetbrains.plugins.ruby.version.management.chruby.ChrubySdkRefresher

    • asdf: #org.jetbrains.plugins.ruby.version.management.asdf.AsdfSdkRefresher

    • Mise: #org.jetbrains.plugins.ruby.version.management.mise.MiseSdkRefresher

    自定义调试日志配置对话框

    点击 确定。

  3. 重启 RubyMine。

  4. 打开 日志文件并确保其中包含与您的版本管理器对应的条目,例如:

    2018-07-30 16:57:18,237 [7350] DEBUG - management.asdf.AsdfSdkRefresher - Refreshing sdks
  5. 创建问题并附上日志。

2026年 11月 9日