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 正常运行。
在 设置 对话框(Ctrl+Alt+S )中,选择 Plugins。
开始输入插件名称。
请执行以下操作之一:
如果未安装该插件,请点击 安装。 等待 RubyMine 安装插件,并确保其已启用。 如果没有,点击 Enable。
如果插件已安装,请找到该插件并确保其已启用。 如果没有,请点击 Enable。
下图显示了插件处于启用状态。

应用更改并关闭设置对话框。
配置 WSL
从 Microsoft Store 下载并安装一个 WSL 发行版(例如 Ubuntu)到你的 Windows 设备上。
此步骤请务必使用至少 Windows 10 或更高版本,并安装最新的“秋季创作者更新”(最低版本 1709,构建 16299.15)。 请参阅官方指南 Install the Windows Subsystem for Linux了解详细说明。
要使用 WSL 2 ,您的 Windows 版本应为 10 版本 18917 或更高版本。 请遵循 这些指示来切换分布式。
运行 Linux 发行版。
首次启动时,系统可能会提示您启用 Windows 可选功能。 在这种情况下,您需要执行以下操作:
以管理员身份打开 Windows PowerShell 并运行
Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux重新启动您的计算机。
(可选) 如果您的 Linux 发行版未附带
rsync,您需要安装它,例如:apt-get install rsyncyum install rsync
您可以创建一个项目并将其存储在 WSL 环境中,从 WSL 文件系统中打开一个项目,并在 WSL 中进一步开发您的项目。
在 WSL 文件系统中创建一个新项目
安装并运行 RubyMine,方式与平时在 Windows 本地操作相同。
在 欢迎屏幕 上,点击 新建项目 或从主菜单中选择 。

在打开的页面上,选择项目类型,并为以下字段提供详细信息:
名称 :项目名称
项目位置 :项目在 WSL 上的位置。 可以直接输入或粘贴路径,或点击 浏览 按钮,使用文件浏览器查找目录。
项目路径的语法如下:
\\wsl.localhost\DistributionName\home\UserName\ProjectNameDistributionName是 Linux 发行版名称,UserName是您的用户目录名称。请查看以下示例:
\\wsl.localhost\Ubuntu\home\test\MyProject。解释器 :安装在 WSL 中的 Ruby 解释器或版本管理器可执行文件。
Rails 版本 (如果选择了 Rails 应用程序类型):选择要在项目中使用的 Rails 版本。 如果所选解释器中未安装 Rails gem,或缺少所需的 Rails 版本,请点击字段中的 + 图标。 等待 RubyMine 下载所有可用的 Rails 版本,然后从下拉列表中选择所需版本。 点击 确定 继续。
点击 创建。

RubyMine 会创建一个位于 WSL 中的项目,并且可以在不离开 IDE 的情况下,在 WSL 环境中开发和构建项目。
在 WSL 文件系统中打开项目
在 RubyMine,您可以直接打开存储在 WSL 文件系统中的项目,并像处理其他项目一样进行操作。
请点击 打开 在 欢迎屏幕或从主菜单中选择 。
在打开的对话框中,指定项目位置:插入 WSL 文件系统中文件夹的路径,或使用文件浏览器找到该文件夹。
路径语法为
\\wsl.localhost\DistributionName,其中DistributionName是您的 Linux 发行版名称,例如 Ubuntu、Debian、Arch 等。
点击 确定。 RubyMine 将在 本机模式 下打开项目。
如果这是打开的第一个 WSL 项目,并且没有旧版 WSL 解释器,RubyMine 将启用本机 WSL 解释器,并检测安装在 WSL 中的 Ruby。 否则,可以 切换到本机解释器 ,在 Ruby 设置页面上进行。
配置项目位置
可以确保创建或打开的任何项目都使用合适的 WSL 位置。
WSLg
WSLg 允许运行 Linux GUI 应用程序,并在 Windows 桌面上显示其输出。
不建议通过 WSLg 运行 RubyMine。 RubyMine 已提供原生 WSL 集成,这是首选方法。
请记住以下事项:
WSLg 在渲染、弹出窗口、窗口管理、输入方法和桌面集成方面存在限制。
对于通过 WSLg 运行 RubyMine,我们不提供专门支持、安装指导、入门引导或特定于产品的修复。
要了解如何打开项目,请参阅 在 WSL 文件系统中打开项目 ;如果想创建新项目,请参阅 在 WSL 文件系统中创建一个新项目。
