# 配置 Ruby 解释器

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

> **TL;DR**
> 配置：  `项目结构 | 项目设置 | 模块 | Ruby 解释器`
>
>
>
> 必需插件： [Ruby](ruby-plugin.html)

要在 IntelliJ IDEA 中处理您的 Ruby 代码，您需要配置至少一个 Ruby 解释器。 IntelliJ IDEA 使用在  `项目结构 | 项目设置 | 模块 | Ruby 解释器`  中选择的解释器来运行代码、解析 gem 并提供代码洞察。

首次打开项目时，IntelliJ IDEA 可以根据项目文件中指定的 Ruby 版本 [自动选择解释器](#automatic_ruby_interpreter_selection)。 也可以随时 [手动选择或更改解释器](#select_ruby_interpreter)。

Ruby 解释器的配置取决于您 [installed it](https://www.jetbrains.com/zh-cn/help/ruby/set-up-a-ruby-development-environment.html#ruby)的方式：

* 如果使用 [版本管理器](https://www.jetbrains.com/zh-cn/help/ruby/ruby-version-managers.html)或 Homebrew （在 macOS 或 Linux 上）安装了 Ruby，IntelliJ IDEA 会自动检测解释器。 在这种情况下，可以 [选择所需版本](#select_ruby_interpreter)。

* 如果使用其他软件包管理器（例如适用于 Ubuntu 的 apt ）或 Ruby 安装程序（例如适用于 Windows 的 RubyInstaller ）安装了 Ruby，则需要 [手动添加它](#add_local_ruby_interpreter)。

* 如果您 [直接从 IntelliJ IDEA 安装了 Ruby](creating-and-running-your-first-language-project.html#create_empty_app)，安装的解释器将设置为当前项目的默认解释器。

* 如果使用安装在隔离环境中的 Ruby，例如 Docker 或可通过 SSH 访问的远程计算机，IntelliJ IDEA 允许将其配置为 [远程解释器](#add_remote_ruby_interpreter)。

## 新项目的自动解释器选择

首次打开项目时（例如，没有  `.idea`  目录的项目），IntelliJ IDEA 会从项目文件中读取所需的 Ruby 版本，并将其与  `项目结构 | 项目设置 | 模块 | Ruby 解释器`  中列出的解释器进行比较。 此列表包括 IntelliJ IDEA 在计算机上检测到的解释器（例如，使用 Homebrew、rbenv、RVM、asdf 或 mise 安装的解释器）以及 [手动添加](#add_local_ruby_interpreter)的解释器。

### IntelliJ IDEA 如何确定所需版本

IntelliJ IDEA 按以下顺序查找所需的 Ruby 版本，并使用找到的第一个版本：

1.

版本管理器文件，例如  `.ruby-version` 、  `.tool-versions` （asdf、mise）或  `.versions.conf` （RVM）。

2.

`ruby`  指令，位于  `Gemfile`  或  `gems.rb`  中。 它支持精确版本（  `ruby "3.3.1"` ）、边界（  `ruby ">= 3.1.0"` ）和悲观约束（  `ruby "~> 3.3"` ）。

### 如何选择解释器

|  条件  |  IntelliJ IDEA 操作  |
| --- | --- |
|  一个解释器匹配  |     IntelliJ IDEA 为项目选择该解释器。     |
|  多个解释器匹配  |     IntelliJ IDEA 不会选择解释器，并显示   发现配置问题   通知，以便可以手动选择一个。     |
|  没有匹配的解释器  |     IntelliJ IDEA 不会选择解释器，并显示包含所需版本的通知。 可以选择让系统安装它，也可以手动配置它。     |
|  未指定版本  |     IntelliJ IDEA 选择最新安装的 Ruby。     |

> **Tip:**
> 有关支持的 Ruby 版本的更多信息，请参阅 [此页面](https://www.jetbrains.com/zh-cn/help/ruby/supported-ruby-versions.html)。

## 添加本地解释器

Procedure: 添加解释器

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 解释器   页面上，点击 ![添加](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) 按钮并选择   解释器  ：

![新建本地解释器](https://resources.jetbrains.com/help/img/idea/2026.3/ij_add_local_ruby_interpreter.png)

3. 请提供 Ruby 可执行文件的路径，例如：

* `/usr/bin/ruby` 在 Linux 系统上安装的 Ruby 使用 apt 。

* `C:\Ruby33-x64\bin\ruby.exe` 用于 Windows 上安装的 Ruby 使用 RubyInstaller 。

IntelliJ IDEA 将显示添加的解释器以及自动检测到的解释器。

要从列表中移除解释器，请选择它，然后点击 ![移除](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.remove.svg)按钮。

Procedure: 添加自定义环境的解释器

IntelliJ IDEA 允许您使用自定义环境在 IntelliJ IDEA 中运行任何 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   页面上，点击 ![添加](https://resources.jetbrains.com/help/img/idea/2026.3/env.sh` > **Tip:** > 请注意， `*.sh` 文件的末尾应有 `"$@"` ，以允许 IntelliJ IDEA 传递一些添加解释器所需的命令。

* 如果您使用 [direnv](https://github.com/direnv/direnv) 加载和卸载环境变量，请将包含 `.envrc` 文件的目录路径传递给 `direnv exec` 命令。 示例： `direnv exec /Users/jetbrains/sample_app`

* 如果您使用 [Shadowenv](https://github.com/Shopify/shadowenv)定制您的项目环境，请将项目目录的路径传递给 `shadow exec` 命令。 示例： `shadowenv exec --dir /Users/jetbrains/sample_app --`

点击   OK  添加一个解释器。

4. 选择添加的解释器，然后在   OK  对话框中点击   设置  。

> **Note: 限制**
> 使用自定义环境的解释器不支持 Ruby 版本管理器。 不要将自定义环境与 rbenv 管理的解释器结合使用。 rvm、asdf 等。
>
>
>
> 请仅使用版本管理器管理的解释器或具有自定义环境的解释器。
>
>
>
> 如果两者都需要，请使用包装器脚本来配置环境，并通过版本管理器启动 Ruby。

## 选择自动检测的解释器

Procedure: 在 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 解释器。 您也可以选择用于 RVM 和 rbenv 版本管理器的 gemset。

![Ruby 解释器](https://resources.jetbrains.com/help/img/idea/2026.3/ij_local_sdk_gems_page.png)

3. 对于所选的 Ruby 解释器/gemset，您可以在右侧看到已安装的 gems。

Procedure: 使用 Run Anything 切换解释器

如果您使用 RVM 或 rbenv 管理本地 Ruby 解释器，您可以使用 [Run Anything](running-anything.html)快速设置所需的解释器：

1. 按两次 `Ctrl` (Windows), `Ctrl` (macOS), `Ctrl` (IntelliJ IDEA Classic (macOS)), `Ctrl` (macOS System Shortcuts), `Ctrl` (XWin), `Ctrl` (GNOME), `Ctrl` (KDE), `Ctrl` (Emacs), `Ctrl` (Sublime Text), `Ctrl` (Sublime Text (macOS)), `Ctrl` (Visual Studio), `Ctrl` (Visual Studio (macOS)), `Ctrl` (NetBeans), `Ctrl` (Eclipse), `Ctrl` (Eclipse (macOS))。

2. 在弹出窗口中，开始输入  `rvm use`  或  `rbenv shell` ，选择所需的解释器并按 `Enter` (Windows), `⏎` (macOS), `⏎` (IntelliJ IDEA Classic (macOS)), `⏎` (macOS System Shortcuts), `Enter` (XWin), `Enter` (GNOME), `Enter` (KDE), `Enter` (Emacs), `Enter` (Sublime Text), `⏎` (Sublime Text (macOS)), `Enter` (Visual Studio), `⏎` (Visual Studio (macOS)), `Enter` (NetBeans), `Enter` (Eclipse), `⏎` (Eclipse (macOS))。

3. （可选）如有必要，请点击弹出窗口中通知解释器已更改的   回滚  按钮。

> **Tip:**
> 请注意，IntelliJ IDEA 支持基于项目文件 [使用 Ruby 版本管理器](https://www.jetbrains.com/zh-cn/help/ruby/ruby-version-managers.html)。

## 添加远程解释器

> **Note:**
> 对于位于远程计算机上的项目，建议使用 [远程开发](remote.html)而不是远程解释器。 使用远程开发时，IDE 后端在远程计算机上运行，并支持所有 IDE 功能。

各种远程开发工具，如 Docker、SSH 或适用于 Linux 的 Windows 子系统 (WSL)，允许使用隔离环境开发应用程序。 这在多种情况下都很有用，例如，如果您想：

* 在隔离环境中进行开发，以避免影响您的本地计算机配置。

* 在相同操作系统上运行、调试和测试您的应用程序。

* 使用 Windows Subsystem for Linux 开发部署到 Linux 的应用程序。

可以使用 Docker、Docker Compose、可通过 SSH 访问的远程计算机或 WSL，在远程环境中准备所需的 Ruby 或 Rails 设置。 然后，您可以在 IntelliJ IDEA 中添加 [remote Ruby interpreter](#add_remote_ruby_interpreter)，并在 IDE 中的隔离环境中 [运行](running-applications.html)、 [调试](debugging-code.html)和 [测试](performing-tests.html)您的应用程序。

请注意，当您使用远程解释器时，IntelliJ IDEA会从远程机器下载 gems 到本地缓存，以便能够使用代码洞察功能。 在这种情况下，您可能会遇到在远程机器上安装了新的 gems，而这些操作是在 IDE 之外进行的。 要更新存储在本地缓存中的一组 gem，请点击   同步 gems   ![同步 gems](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.download.svg)按钮在   Ruby 解释器  页面。

配置远程 Ruby 解释器，请按照以下步骤操作：

Procedure:

1. 在工具栏上，点击 ![添加](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)，然后选择   远程解释器或版本管理器  。

![新的远程解释器](https://resources.jetbrains.com/help/img/idea/2026.3/ij_add_remote_ruby_interpreter.png)

2. 在   配置远程 Ruby 解释器   对话框中，执行下方相应选项卡中提供的步骤。

SSH:

> **Note: 先决条件**
> 在执行以下步骤之前，请确保已设置 SSH 并添加了 SSH 配置。 详细信息请参阅 [本主题](running-ssh-terminal.html)。

Procedure:

1. 指定以下选项：

![配置远程 Ruby 解释器：SSH](https://resources.jetbrains.com/help/img/idea/2026.3/rm_remote_attach_ssh_credentials.png)

* SSH 配置 ：展开现有 SSH 配置列表，或点击省略号按钮并创建新配置。

* Ruby 或版本管理器路径 ：指定 Ruby 解释器或版本管理器可执行文件的路径。

2. 点击   OK  。 如果您在上一步指定了版本管理器可执行文件的路径，IntelliJ IDEA 会建议选择用于运行远程应用程序的 Ruby 解释器。

3. 在   Ruby   页面上，选择已添加的解释器并点击   OK  。

Docker:

> **Note: 先决条件**
> 在执行以下步骤之前，请确保已构建 Docker 镜像。 详细信息请参阅 [本主题](docker-images.html#build-image)

Procedure:

1. 在调用的对话框中，选择   Docker  并指定以下选项：

![配置远程 Ruby 解释器：Docker](https://resources.jetbrains.com/help/img/idea/2026.3/docker_tutorial_configure_remote.png)

* 服务器 ：指定用于运行容器的 Docker 服务器。

* 镜像名称 ：选择 [先前构建的镜像](docker-images.html#build-image)。

* Ruby 或版本管理器路径 ：保留默认的 `ruby` 值，以自动检测 Ruby 解释器的路径。

2. 点击   OK  。 如果您在上一步指定了版本管理器可执行文件的路径，IntelliJ IDEA 会建议选择用于运行远程应用程序的 Ruby 解释器。

已添加的解释器现在在   Ruby   页面上可用。

3. 选择添加的解释器，然后在   OK  对话框中点击   Ruby 解释器  。

等待 IntelliJ IDEA 完成项目分析过程并创建帮助程序 Docker 镜像和容器。

![Docker 工具窗口](https://resources.jetbrains.com/help/img/idea/2026.3/docker_tutorial_dockerfile_tool_window_add_interpreter.png)

Docker Compose:

> **Note: 先决条件**
> 在执行以下步骤之前，请确保已构建 Docker Compose 应用程序。 详细信息请参阅 [本主题](docker-compose.html#create-docker-compose-run-configuration)。

Procedure:

1. 在调用的对话框中，选择   Docker Compose  并指定以下选项：

![配置远程 Ruby 解释器：Docker Compose](https://resources.jetbrains.com/help/img/idea/2026.3/docker_tutorial_configure_remote_compose.png)

* 服务器 ：此选项指定用于运行容器的 Docker 服务器。

* 配置文件 ：保留 `docker-compose.yml` 文件。

* 服务 ：选择 web 服务。

* 环境变量 ：通常无需更改。 如果确需自定义，点击 编辑环境变量 图标以打开 环境变量 对话框。 您可以添加新变量（点击 + 图标），也可以编辑默认包含的系统环境变量。 ![编辑环境变量](https://resources.jetbrains.com/help/img/idea/2026.3/rm_docker_compose_edit_variables.png)

* Node.js 运行时路径 ：保留默认的 `ruby` 值，以自动检测 Ruby 解释器的路径。 您也可以手动指定解释器或版本管理器可执行文件的路径。

2. 点击   OK  。 如果您在上一步指定了版本管理器可执行文件的路径，IntelliJ IDEA 会建议选择用于运行远程应用程序的 Ruby 解释器。

已添加的解释器现在在   Ruby   页面上可用。

![Ruby 解释器： Docker Compose](https://resources.jetbrains.com/help/img/idea/2026.3/docker_tutorial_ruby_sdk_page_compose.png)

3. 选择添加的解释器，然后在   OK  对话框中点击   Ruby 解释器  。

等待 IntelliJ IDEA 完成项目分析过程并创建帮助程序 Docker 镜像和容器。

![Docker 工具窗口：帮助程序](https://resources.jetbrains.com/help/img/idea/2026.3/docker_tutorial_compose_tool_window_helpers.png)

> **Note:**
> Ruby 帮助程序是 IntelliJ IDEA 为测试和调试目的创建的附加容器和 Docker 镜像。 它们包含 gem 和  `.rb`  脚本，IntelliJ IDEA 使用这些脚本来准备测试环境、转换测试库（例如 Minitest、RSpec、Cucumber）的输出、启动测试等等。

Procedure: （可选）编辑本地与远程项目文件之间的映射

1. 指定本地项目和远程项目文件之间的映射。 要执行此操作，请点击 ![编辑路径映射](https://resources.jetbrains.com/help/img/idea/2026.3/app.vcs.folders.svg)按钮。

![编辑路径映射](https://resources.jetbrains.com/help/img/idea/2026.3/ij_edit_path_mappings.png)

2. 在   编辑项目路径映射  对话框中，指定本地和远程项目根路径。

![编辑项目路径映射](https://resources.jetbrains.com/help/img/idea/2026.3/rm_remote_attach_path_mappings.png)

请注意，IntelliJ IDEA 会检测 Vagrant [同步文件夹](https://www.vagrantup.com/docs/synced-folders/)、WSL 映射等。 这些映射列在此对话框中，无法更改。

> **Tip:**
> 默认情况下，安装在 Linux 或 macOS 上的 IntelliJ IDEA 会使用 rsync 实用程序下载远程 gems。 这会加快下载过程。 您可以通过使用 IntelliJ IDEA 注册表更改默认行为并禁用 rsync 的使用。 要调用   注册表   对话框，按 `Ctrl+Shift+A` (Windows), `⌘ ⇧ A` (macOS), `⌘ ⇧ A` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ P` (macOS System Shortcuts), `Ctrl+Shift+A` (XWin), `Ctrl+Shift+A` (GNOME), `Ctrl+Shift+A` (KDE), `Escape, X` (Emacs), `Ctrl+Shift+P` (Sublime Text), `⌘ ⇧ P` (Sublime Text (macOS)), `Ctrl+Shift+A` (Visual Studio), `⌘ ⇧ A` (Visual Studio (macOS)), `Ctrl+I` (NetBeans), `Ctrl+Shift+A` (Eclipse), `⌘ 3` (Eclipse (macOS)) 或从主菜单中选择  `帮助 | 查找操作` 。 在打开的弹出窗口中，开始键入  `注册表` ，选择相应的项并按 `Enter` (Windows), `⏎` (macOS), `⏎` (IntelliJ IDEA Classic (macOS)), `⏎` (macOS System Shortcuts), `Enter` (XWin), `Enter` (GNOME), `Enter` (KDE), `Enter` (Emacs), `Enter` (Sublime Text), `⏎` (Sublime Text (macOS)), `Enter` (Visual Studio), `⏎` (Visual Studio (macOS)), `Enter` (NetBeans), `Enter` (Eclipse), `⏎` (Eclipse (macOS))。 然后，使用以下选项启用或禁用 rsync：
>
>
>
> * Linux 和 macOS： `ide.remote.interpreters.use.rsync`
>
> * Windows: `ide.remote.interpreters.rsync.enabled.on.windows`

## 编辑解释器

您可以自定义 Ruby 解释器的名称，以便快速区分并避免重复。

Procedure:

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 解释器并选择   编辑名称  。

![在代码和 Ruby 解释器中重命名参数](https://resources.jetbrains.com/help/img/idea/2026.3/ij_edit_interpreter.png)

或者，您可以选择所需的 Ruby 解释器并使用 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.edit.svg) 图标或按 `Enter` (Windows), `⏎` (macOS), `⏎` (IntelliJ IDEA Classic (macOS)), `⏎` (macOS System Shortcuts), `Enter` (XWin), `Enter` (GNOME), `Enter` (KDE), `Enter` (Emacs), `Enter` (Sublime Text), `⏎` (Sublime Text (macOS)), `Enter` (Visual Studio), `⏎` (Visual Studio (macOS)), `Enter` (NetBeans), `Enter` (Eclipse), `⏎` (Eclipse (macOS))。

3. 在   编辑解释器   对话框中，提供解释器的新名称并点击   OK  。

![为 Ruby 解释器输入一个新名称](https://resources.jetbrains.com/help/img/idea/2026.3/rm_edit_interpreter_dialog.png)

## 创建 RVM gemset

要创建 RVM gemset，请打开   产品结构  对话框（ `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))），转到   模块 | Ruby 解释器  ，然后执行以下步骤：

Procedure:

1. 右键点击所需的解释器并选择   新建 RVM gemset

![Ruby 解释器页面](https://resources.jetbrains.com/help/img/idea/2026.3/ij_gemsets_rvm_sdk_page_example_initial.png)

2. 在打开的对话框中，选择将为其创建 gemset 的   Ruby 解释器  。 然后，指定 gemset 名称并点击   OK  ：

![创建新 rvm gemset 对话框](https://resources.jetbrains.com/help/img/idea/2026.3/rm_gemsets_rvm_sdk_page_new_gemset_dialog.png)

3. Ruby 解释器  页面会将 gemset 显示为所选解释器的子项：

![Ruby 解释器页面](https://resources.jetbrains.com/help/img/idea/2026.3/ij_gemsets_rvm_sdk_page_created_asterisk.png)

请注意，星号会附加到 gemset 名称。 这意味着 gemset 尚未创建。 要创建它，请在   产品结构   对话框中点击   应用   或   OK  。

## 故障排除

Procedure: 为 Ruby 项目配置本地解释器

如果您在为新克隆的 Ruby 项目配置本地解释器时遇到问题（例如，   Ruby 解释器   页面未显示），请尝试从现有源打开该项目。

1. 在主菜单中，前往  `文件 | 新建 | 从现有源创建项目` 。

2. 请提供您的项目路径。

3. 在   导入项目  对话框中，选择   从现有源代码创建项目  选项，然后点击   下一步  。

4. 指定项目名称和您希望在其中创建项目的目录路径。 点击   下一步  。

5. 请选择要添加到项目根目录的目录，然后点击   下一步  。

6. 请选择您希望在项目中使用的框架。 点击   完成  。

一旦 IntelliJ IDEA 打开您的项目，请按照 [添加解释器](#add_local) 中描述的步骤配置本地解释器。

## 移除解释器

> **Note:**
> 您只能移除手动添加到   Ruby 解释器   列表中的解释器。
>
> 自动检测到的解释器
>
> IDE UI 不允许移除以下内容：
>
>
>
> * 自动检测到的解释器（系统 Ruby、rbenv、rvm、asdf 等）
>
> * 使用自定义环境结合 Ruby 版本管理器创建的解释器

Procedure:

1. 转到  `项目结构 | 项目设置 | 模块 | Ruby 解释器`

2. 从解释器列表中，选择要移除的手动添加的解释器。

3. 点击 ![移除](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.remove.svg) 按钮，该按钮位于   Ruby   页面顶部的工具栏中。

![移除已添加的解释器](https://resources.jetbrains.com/help/img/idea/2026.3/ij_remove_interpreter.png)

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

## See also

### 概念

[项目](creating-and-managing-projects.html)

