IntelliJ IDEA 2025.1 Help

Ruby 版本管理器

在 Linux 或 macOS 上安装 Ruby 的最最受欢迎的方法是使用版本管理器,例如, RVMrbenv。 版本管理器允许您在您的机器上安装多个 Ruby 版本,并在它们之间快速切换。 IntelliJ IDEA 会自动检测本地机器上安装并由以下版本管理器维护的解释器:

您可以在现有项目的 Ruby Interpreters页面上切换 Ruby 解释器(以及 RVMrbenv 的 gemsets),并在 创建新项目时选择所需的解释器。

自动建议的 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 模块的解释器设置不匹配,IntelliJ IDEA 将显示通知:

  • 如果 IntelliJ IDEA 检测到您的机器上安装了所需的 Ruby 版本,它将建议将其设置为当前项目的解释器。 点击通知中的按钮进行切换。

  • 仅适用于 Linux/macOS:如果未找到所需的 Ruby 版本,并且您使用 rbenvRVMruby-build ,IntelliJ IDEA 将建议 使用您的版本管理器安装该版本

远程 Ruby 解释器

IntelliJ IDEA 允许您使用通过版本管理器维护的 远程 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

ruby-build

/home/jetbrains/.asdf/bin/asdf (对于 jetbrains用户)

Mise

/home/jetbrains/.local/bin/mise (对于 jetbrains用户)

调试 Ruby 解释器检测

如果您在检测由版本管理器维护的本地 Ruby 解释器时遇到问题,请按照以下步骤操作,以帮助我们确定问题的原因:

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

  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

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

    点击 OK

  3. 重启 IntelliJ IDEA。

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

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

最后修改日期: 2025年 4月 24日