# 向您的项目添加 Ruby 模块

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

本过程介绍了如何向您的项目添加 Ruby 模块，使您能够在 IntelliJ IDEA 环境中无缝运行 Ruby 代码。 按照此过程操作可以确保 IDE 能识别您的 Ruby 文件、提供代码洞察，并允许脚本和模块的正确执行。

在执行本过程之前，请先完成以下操作：

* 请下载并安装适用于您的平台的 [Ruby distribution](https://www.jetbrains.com/zh-cn/help/ruby/set-up-a-ruby-development-environment.html#ruby)。

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

## 添加 Ruby 模块

Procedure: 添加 Ruby 模块

1. 在   项目   工具窗口中选择顶级目录，然后点击工具栏上的 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) 或按 `Alt+Insert` (Windows), `⌘ N` (macOS), `⌃ N` (IntelliJ IDEA Classic (macOS)), `⌘ N` (macOS System Shortcuts), `Alt+Insert` (XWin), `Alt+Insert` (GNOME), `Alt+Insert` (KDE), `Alt+Insert` (Emacs), `Ctrl+N` (Sublime Text), `⌘ N` (Sublime Text (macOS)), `Ctrl+N` (Visual Studio), `⌘ N` (Visual Studio (macOS)), `Alt+Insert` (NetBeans), `Alt+Insert` (Eclipse), `⌘ N` (Eclipse (macOS))。

2. 选择   模块  。

![将模块添加到项目](https://resources.jetbrains.com/help/img/idea/2026.3/add_module_to_project.png)

3. 在左侧列表中，选择   Ruby  。

> **Note:**
> 此选项仅在安装并启用 Ruby 插件后可用。

IDE 会检测并预选您的 Ruby 解释器。

4. 请为该模块提供一个名称。

5. （可选）选择   添加示例代码   以向模块添加一个示例  `hello.rb`  Ruby 文件。

6. 点击   创建   按钮以完成该过程并关闭对话框。

![配置 Ruby 模块](https://resources.jetbrains.com/help/img/idea/2026.3/configure_ruby_module.png)

Procedure: 为 Ruby 模块配置 Ruby 解释器

您可以配置在创建模块时未选中的其他 Ruby 解释器。

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. 导航到   模块   并选择您的 Ruby 模块。

3. 在   Ruby 解释器   选项卡中，使用以下选项之一：

* 选择您之前安装的自动检测到的解释器之一。

* [添加 IDE 未检测到的本地解释器](configuring-language-interpreter.html#add_local)。

* [添加远程解释器](configuring-language-interpreter.html#add_remote_ruby_interpreter)。

![为 Ruby 模块选择解释器](https://resources.jetbrains.com/help/img/idea/2026.3/ruby_module_selection.png)

4. 在打开的对话框中点击   OK  。

