RubyMine 2026.3 Help

WSL

WSL (WSL 2 )——Windows Subsystem for Linux——是一个兼容层,用于在 Windows 10 及更高版本上本地运行 Linux 二进制可执行文件。 目前,它支持若干 Linux 发行版 ,例如 Ubuntu、OpenSUSE 和 SLES。

本机模式

从 2026.3 版本开始,RubyMine 将以本机模式打开存储在 WSL 文件系统中的项目。 要使用此类项目,请在 Windows 上运行的 RubyMine 中 打开它 ,并使用 本机 WSL 解释器 运行 Ruby。

在本机模式下,RubyMine 在本地计算机上运行,并直接处理存储在 WSL 或 Dev Container 中的项目。 代码、Ruby 安装、gem 和工具保留在 Linux 环境中。 环境中的轻量级代理负责处理文件访问和进程执行。

与 远程开发 相比,本机模式的工作方式如下:

  • RubyMine 不会在环境中下载或安装 IDE 后端。

  • 项目会在常规 RubyMine 窗口中打开,而不是在单独的客户端中打开。 本地设置、插件和按键映射会照常应用。

  • Linux 路径和符号链接会被正确处理,而不会转换为 Windows 路径。

与旧版远程解释器相比, 本机解释器 不需要路径映射,也不会将帮助程序脚本复制到环境中。 RubyMine 直接在环境中运行 Ruby、Bundler、测试和其他工具。

当项目位于通过 SSH 连接的远程计算机上时,远程开发仍是推荐选项。

启用远程执行代理插件。

请确保此插件已安装并启用,以保证您的 IDE 正常运行。

  1. 在 设置 对话框(Ctrl+Alt+S )中,选择 Plugins。

  2. 开始输入插件名称。

  3. 请执行以下操作之一:

    • 如果未安装该插件,请点击 安装。 等待 RubyMine 安装插件,并确保其已启用。 如果没有,点击 Enable。

    • 如果插件已安装,请找到该插件并确保其已启用。 如果没有,请点击 Enable。

    下图显示了插件处于启用状态。

    远程执行代理插件
  4. 应用更改并关闭设置对话框。

配置 WSL

  1. 从 Microsoft Store 下载并安装一个 WSL 发行版(例如 Ubuntu)到你的 Windows 设备上。

    此步骤请务必使用至少 Windows 10 或更高版本,并安装最新的“秋季创作者更新”(最低版本 1709,构建 16299.15)。 请参阅官方指南 Install the Windows Subsystem for Linux了解详细说明。

    要使用 WSL 2 ,您的 Windows 版本应为 10 版本 18917 或更高版本。 请遵循 这些指示来切换分布式。

  2. 运行 Linux 发行版。

    首次启动时,系统可能会提示您启用 Windows 可选功能。 在这种情况下,您需要执行以下操作:

    • 以管理员身份打开 Windows PowerShell 并运行

      Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux
    • 重新启动您的计算机。

  3. (可选) 如果您的 Linux 发行版未附带 rsync ,您需要安装它,例如:

    apt-get install rsync
    yum install rsync

您可以创建一个项目并将其存储在 WSL 环境中,从 WSL 文件系统中打开一个项目,并在 WSL 中进一步开发您的项目。

在 WSL 文件系统中创建一个新项目

  1. 安装并运行 RubyMine,方式与平时在 Windows 本地操作相同。

  2. 在 欢迎屏幕 上,点击 新建项目 或从主菜单中选择 文件 | 新建项目。

    在 WSL 中创建项目:欢迎屏幕
  3. 在打开的页面上,选择项目类型,并为以下字段提供详细信息:

    1. 名称 :项目名称

    2. 项目位置 :项目在 WSL 上的位置。 可以直接输入或粘贴路径,或点击 浏览 按钮,使用文件浏览器查找目录。

      项目路径的语法如下:

      \\wsl.localhost\DistributionName\home\UserName\ProjectName

      DistributionName 是 Linux 发行版名称, UserName 是您的用户目录名称。

      请查看以下示例: \\wsl.localhost\Ubuntu\home\test\MyProject。

    3. 解释器 :安装在 WSL 中的 Ruby 解释器或版本管理器可执行文件。

    4. Rails 版本 (如果选择了 Rails 应用程序类型):选择要在项目中使用的 Rails 版本。 如果所选解释器中未安装 Rails gem,或缺少所需的 Rails 版本,请点击字段中的 + 图标。 等待 RubyMine 下载所有可用的 Rails 版本,然后从下拉列表中选择所需版本。 点击 确定 继续。

  4. 点击 创建。

    在 WSL 中选择项目位置

    RubyMine 会创建一个位于 WSL 中的项目,并且可以在不离开 IDE 的情况下,在 WSL 环境中开发和构建项目。

在 WSL 文件系统中打开项目

在 RubyMine,您可以直接打开存储在 WSL 文件系统中的项目,并像处理其他项目一样进行操作。

  1. 请点击 打开 在 欢迎屏幕或从主菜单中选择 文件 | 打开。

  2. 在打开的对话框中,指定项目位置:插入 WSL 文件系统中文件夹的路径,或使用文件浏览器找到该文件夹。

    路径语法为 \\wsl.localhost\DistributionName ,其中 DistributionName 是您的 Linux 发行版名称,例如 Ubuntu、Debian、Arch 等。

    在 WSL 中打开现有项目
  3. 点击 确定。 RubyMine 将在 本机模式 下打开项目。

    如果这是打开的第一个 WSL 项目,并且没有旧版 WSL 解释器,RubyMine 将启用本机 WSL 解释器,并检测安装在 WSL 中的 Ruby。 否则,可以 切换到本机解释器 ,在 Ruby 设置页面上进行。

配置项目位置

可以确保创建或打开的任何项目都使用合适的 WSL 位置。

  1. 按 Ctrl+Alt+S 打开设置,然后选择 外观与行为 | 系统设置。

  2. 在 Project 部分下,在 默认项目目录 字段中指定合适的 WSL 目录,然后点击 确定 保存更改。

    默认项目目录

    从现在开始,每当 创建、 打开或 克隆项目时,都会默认选择指定的目录。

WSLg

WSLg 允许运行 Linux GUI 应用程序,并在 Windows 桌面上显示其输出。

不建议通过 WSLg 运行 RubyMine。 RubyMine 已提供原生 WSL 集成,这是首选方法。

请记住以下事项:

  • WSLg 在渲染、弹出窗口、窗口管理、输入方法和桌面集成方面存在限制。

  • 对于通过 WSLg 运行 RubyMine,我们不提供专门支持、安装指导、入门引导或特定于产品的修复。

要了解如何打开项目,请参阅 在 WSL 文件系统中打开项目 ;如果想创建新项目,请参阅 在 WSL 文件系统中创建一个新项目。

2026年 11月 9日