RubyMine 2025.3 Help

WSL

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

配置 WSL

  1. 从 Microsoft Store 下载并安装一个 WSL 发行版（例如，Ubuntu）。

    此步骤请务必使用至少 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 发行版

RubyMine 允许您使用运行在 WSL 上的 自定义 Linux 发行版。 这可以通过编辑 RubyMine 在检测到 WSL 后自动创建的 wsl.distributions.xml 配置文件来完成。

添加自定义发行版

  1. 打开 %APPDATA%\JetBrains\<product><version>\config\options\wsl.distributions.xml 文件。

  2. 添加 descriptor 元素并提供访问自定义发行版的设置。 请注意， id 值应是唯一的。 例如：

    <!-- ... --> <descriptor> <id>DEBIAN_CUSTOM</id> <microsoft-id>Debian</microsoft-id> <executable-path>debian-custom.exe</executable-path> <presentable-name>Debian GNU/Linux - Custom</presentable-name> </descriptor> <!-- ... -->

    您可以通过两种方式指定 executable-path：

    • 指定自定义发行版的可执行文件名称。 在这种情况下，RubyMine 将在 %LOCALAPPDATA%\Microsoft\WindowsApps 中找到自定义发行版。

    • 指定自定义发行版可执行文件的绝对路径。

  3. 重启 RubyMine 并将您的自定义发行版 添加为远程解释器。

最后修改日期： 2025年 12月 5日
PodmanVagrant