# 设置 JRuby 集成

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/idea/llms.txt).

JRuby 通过在 Java 虚拟机 (JVM) 上运行 Ruby 代码，让 Ruby 代码能够与 Java 生态系统无缝集成。 使用 JRuby，开发者可以从 Ruby 访问 Java 库，在 Java 项目中执行 Ruby 脚本，并构建兼具两种语言优势的混合应用程序。

在集成之前，请确保已完成以下操作：

* [已安装并启用 Ruby 插件](ruby-plugin.html#install_plugin_from_repo)。

* [已安装至少一个 JRuby 解释器](https://www.jruby.org/getting-started)。

Procedure: 为项目添加 JRuby 支持

1. 在项目中，转到  `文件 | 项目结构` ，或按 `Ctrl+Alt+Shift+S` (Windows), `⌘ ;` (macOS), `⌘ ;` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ Comma` (macOS System Shortcuts), `Ctrl+Alt+Shift+S` (XWin), `Ctrl+Alt+Shift+S` (GNOME), `Ctrl+Alt+Shift+S` (KDE), `Ctrl+Alt+Shift+S` (Emacs), `Ctrl+Alt+Shift+S` (Sublime Text), `⌘ ;` (Sublime Text (macOS)), `Ctrl+Alt+Shift+S` (Visual Studio), `⌘ ;` (Visual Studio (macOS)), `Ctrl+Alt+Shift+S` (NetBeans), `Ctrl+Alt+Shift+S` (Eclipse), `⌘ ;` (Eclipse (macOS))。

2. 导航到   Facet  ，然后从下拉列表中选择   JRuby  。

![选择 JRuby facet](https://resources.jetbrains.com/help/img/idea/2026.3/ij_jruby_facet_select.png)

3. 在   选择模块   对话框中，选择要使用 JRuby 的模块，然后点击   OK  。

![为 JRuby 选择模块](https://resources.jetbrains.com/help/img/idea/2026.3/ij_jruby_to_module.png)

4. 添加 JRuby facet 后，可以在所选模块中查看它。 IntelliJ IDEA 应会检测所有已安装的 JRuby 解释器。 在这种情况下，请确保已在   Gem 管理器   选项卡上选择所需版本。 对于所选的 Ruby 解释器/gemset，您可以在右侧看到已安装的 gems。

![带有已检测到的 JRuby 解释器的 Gem Manager 选项卡](https://resources.jetbrains.com/help/img/idea/2026.3/ij_jruby_sdk_detected.png)

如果没有自动检测到解释器，请手动选择一个：

1.  点击   添加   选项卡工具栏上的   Gem 管理器   图标。

2.  从下拉列表中选择   解释器  。

![选择解释器选项](https://resources.jetbrains.com/help/img/idea/2026.3/ij_interpreter_for_jruby.png)

3.  在文件浏览器窗口中，导航到所需的 JRuby.exe 文件并选择它。

