rubymine wsl

1. 确认 WSL 环境已就绪
   在开始配置前，先确认你的 Windows 上已安装 WSL 并至少有一个发行版（如 Ubuntu）。在 PowerShell 或 CMD 中运行 wsl --list 查看已安装的发行版。如果没有任何发行版，请先通过 wsl --install 安装。注意，RubyMine 本身不负责安装 WSL，它只负责连接。另外，确认 WSL 内已安装 Ruby、Bundler 等工具，否则 RubyMine 无法定位解释器。
2. 在 RubyMine 中配置 WSL 解释器
   打开 RubyMine，进入 File -> Settings（或 Ctrl+Alt+S），找到 Languages & Frameworks -> Ruby SDK 和 Gems。点击右侧的「+」号，选择「New interpreter」或「Add interpreter」，在弹出窗口中选择 WSL 选项。RubyMine 会列出你已安装的 WSL 发行版，选择目标发行版后，它会自动检测该发行版内的 Ruby 路径。如果未检测到，可手动输入 /usr/bin/ruby 或通过 which ruby 在 WSL 中查询。配置完成后，RubyMine 会将 WSL 中的 Ruby 作为项目解释器。
3. 设置 WSL 终端
   RubyMine 的终端默认使用 Windows 的 cmd 或 PowerShell，但你可以将其切换到 WSL。进入 File -> Settings -> Tools -> Terminal，在 Shell path 一栏输入 wsl.exe（或 wsl.exe -d Ubuntu 指定发行版）。这样打开终端时就会进入 WSL 环境，方便你执行 Rails 命令、bundle install 等操作。注意，如果 WSL 内有多个发行版，建议指定发行版名称，避免默认发行版不是目标。
4. 配置项目路径映射
   当使用 WSL 解释器时，RubyMine 需要知道 Windows 路径与 WSL 路径的对应关系。通常，你的项目位于 Windows 文件系统（如 C:Usersyouproject），RubyMine 会自动将其映射为 /mnt/c/Users/you/project。但如果你在 WSL 内创建项目（如 ~/project），则需要在设置中手动添加路径映射。进入 Settings -> Languages & Frameworks -> Ruby SDK 和 Gems，在 WSL 解释器设置中找到「Path mappings」选项，添加 Windows 路径与 WSL 路径的对应关系，否则 RubyMine 可能无法正确同步文件。
5. 运行与调试
   配置完成后，你可以像使用本地解释器一样运行和调试 Ruby 程序。点击运行按钮，RubyMine 会通过 WSL 执行 Ruby 脚本，输出也会显示在控制台中。调试时，RubyMine 会自动在 WSL 中启动调试服务器，你可以在代码中设置断点，体验与本地一致的调试功能。如果遇到调试器无法连接，检查 WSL 的防火墙设置或确保 WSL 版本为 2，因为 WSL1 的兼容性可能较差。
6. 常见问题：Gem 安装位置
   使用 WSL 后，bundle install 安装的 Gem 会存放在 WSL 的文件系统内（如 /home/you/.rbenv/versions），而不是 Windows 目录。这是正常现象，因为 Ruby 运行在 Linux 环境中。如果你在 RubyMine 中看到 Gem 列表为空，可以点击「Refresh」按钮重新加载。另外，不要尝试在 Windows 侧直接访问 WSL 的 Gem 目录，因为路径转换可能导致权限问题。

软件页面：RubyMine。