RubyMine 2026.3 Help

终端

RubyMine 包含一个嵌入式终端模拟器,可用于直接从 IDE 使用命令行工具。 使用它管理 Git 仓库、设置文件权限、使用 AI 编码代理,以及执行其他命令行任务,而无需切换到专用终端应用程序。

启用 Terminal 插件

此功能依赖于 Terminal 插件,该插件默认在 RubyMine 中捆绑并启用。 如果相关功能不可用,请确保您未禁用该插件。

  1. 按 Ctrl+Alt+S 打开设置,然后选择 Plugins。

  2. 找到 终端 插件并点击 Enable。

该终端由 libghostty 提供支持,这是来自 Ghostty 项目的终端仿真库。

最初,终端模拟器使用默认系统 shell 运行,但它支持许多其他 shell,包括 Windows PowerShell、命令提示符、 sh shell、 bash、 Z shell、 csh 等。 有关更改 shell 的更多信息,请参阅 终端设置。 要在单个选项卡中运行另一个 shell 而不更改默认 shell,请参阅 在另一个 shell 中启动会话。

访问终端工具窗口

  • 请前往 视图|工具窗口|终端 或按 Alt+F12。

    默认情况下,终端模拟器运行时,将当前目录设置为当前 project 的根目录。 有关更改默认起始目录的更多信息,请参阅 终端设置。

  • 右键点击任意文件(例如,在 Project 工具窗口 (Alt+1) 或任何打开的编辑器标签页中),然后选择 在 终端 中打开 ,即可在该文件所在目录内,以新会话方式打开 终端 工具窗口。

终端会话旅程旅程?

本地会话

开始一个新的本地会话

  • 要在单独的选项卡中开始新的会话,请点击工具栏上的 "添加"按钮 或按 Ctrl+Shift+T。

    终端中的新会话
  • 要关闭选项卡,请点击终端工具栏上的 关闭按钮 ,或按下 Ctrl+F4。

  • 要终止正在运行的会话,请通过点击 关闭按钮 关闭标签页,并确认终止该进程。

  • 要在活动选项卡之间切换,请按 Alt+Right 和 Alt+Left。 或者,您可以按 Alt+Down 查看所有终端选项卡的列表。

  • 要清除终端屏幕,请按 ⌘ K。

关闭 project 或 RubyMine 时,终端会保存选项卡和会话。它会保留选项卡名称、当前工作目录,甚至 shell 历史记录。 它会保留标签名称、当前工作目录,甚至是 shell 历史记录。

预定义会话

RubyMine 会自动检测用于预定义会话的常见 shell,并可在新标签页中运行其中任意一个。 选择的 shell 仅应用于当前标签页,不会影响其他标签页。 新创建的标签页会继续使用在 终端设置 中指定的默认 shell。

在检测到的 shell 中启动会话

  1. 在终端工具栏上,点击 新建预定义会话按钮新建预定义会话。

    在检测到的 shell 中启动预定义会话
  2. 从列表中选择一个 shell。 RubyMine 会打开一个以该 shell 命名的新标签页,并在其中启动会话。

列表包含以下 shell:

  • 在 Windows 上: Windows PowerShell、 命令提示符、 PowerShell、 Git Bash 以及已安装的 WSL 发行版。

  • 在 macOS 和 Linux 上: bash、 Z shell、 fish shell 以及 pwsh ,位于 /bin 、 /usr/bin 、 /usr/local/bin 和 /opt/homebrew/bin 中。

这些位置之外的 shell 以及其他 shell 类型不会被自动检测到。 要使用它们,请在 设置 | 工具 | 终端 的 Shell 路径 选项中指定可执行文件的路径。

如果检测到的多个 shell 名称相同,RubyMine 会将其路径附加到名称中,例如 zsh (/bin/zsh) 和 zsh (/opt/homebrew/bin/zsh)。

如果 project 位于 WSL 或 Dev Container 中,列表会按环境对 shell 进行分组,以便可以在该环境或主机上启动会话。

SSH 会话

启用 SSH Remote Run 插件

此功能依赖于 SSH Remote Run 插件,该插件默认捆绑在 RubyMine 中并已启用。 如果相关功能不可用,请确保您未禁用该插件。

  1. 按 Ctrl+Alt+S 打开设置,然后选择 Plugins。

  2. 找到 SSH Remote Run 插件并点击 Enable。

开始新的 SSH 会话

  1. 在终端工具栏中,点击 开始新的 SSH 会话 并选择 新建 SSH 会话。

    开始新的 SSH 会话
  2. 输入要连接的主机地址,并提供身份验证数据。

    在 SSH 会话对话框中提供数据

    或者,如果您已配置了 SSH 配置 ,您可以从列表中选择其中一个。

要终止连接,请在终端选项卡中点击 终止会话。

在终端中工作

  • 要在终端会话中搜索特定字符串,请按 Ctrl+F。 此操作会搜索会话中的所有文本:提示、命令和输出。

默认情况下,搜索不区分大小写。 默认情况下,搜索不区分大小写。您可以点击搜索字段中的 “Match Case” 图标 (区分大小写 )启用区分大小写。

重命名终端选项卡

  • 右键点击选项卡并从上下文菜单中选择 重命名会话。

在终端中使用补全

RubyMine 提供对命令名称、选项和参数的补全,例如路径、 Git 分支、标志等。

当您键入时,建议会自动显示在 终端 工具窗口中。 默认情况下,RubyMine 会显示参数的建议。

  • 要启用子命令、参数和实参的补全,请转到 设置 | 工具 | 终端 | 命令补全 ,然后为 在键入时显示补全弹出窗口 选项选择 始终。

  • 要手动调用补全弹出窗口,请按 Ctrl+Space。

  • 要接受建议,请在列表中选择它并按 Enter。

终端中带有建议的命令补全

终端能够识别并高亮显示文件和文件夹的绝对路径和相对路径。 将鼠标悬停在它们上时,会显示为超级链接。 这样您可以快速导航到编译消息、构建错误或 AI 编码代理响应中引用的位置。

  • 按住 Ctrl 并点击终端中的文件名称以在编辑器中打开它。

  • 按住 Ctrl 并点击终端中带有文件夹名称的链接,可在 Project 工具窗口中定位该文件夹。 如果文件夹位于当前项目之外,RubyMine 将打开默认文件系统资源管理器。

  • 或者,点击文件或文件夹名称,然后在工具提示中使用 打开 链接。

将文件和文件夹拖放到终端上

可以将文件和文件夹从 Project 工具窗口(Alt+1 )或系统文件管理器拖到 终端 工具窗口中。 结果取决于你放置项目的位置。

  • 将文件或文件夹拖放到终端输出区域(1)以在当前会话提示符处粘贴其路径。

    当向 CLI 编码代理发送文件上下文,或运行以路径作为实参的命令时,这很有用。

  • 将文件或文件夹拖放到终端标签区域(2)以打开新标签页,并将工作目录设置为所放置的文件夹,或所放置文件的父文件夹。

将文件拖到终端工具窗口

自定义终端布局

安排终端选项卡以匹配工作流:并排显示多个会话、在编辑器区域打开会话,或将 终端 工具窗口从主窗口中分离出来。

拆分终端选项卡

可以将 终端 工具窗口拆分为多组选项卡,并同时处理多个会话。 例如,在一个组中运行 CLI 编码代理,在另一个组中运行其他 shell 命令。 通过拆分操作打开的新选项卡会在原始选项卡的工作目录中启动会话。

使用向右拆分将终端工具窗口拆分为两组选项卡
  • 要在当前选项卡旁边打开新选项卡,请右键点击该选项卡并选择 向右拆分 或 拆分。

  • 要将标签页移动到单独的组,请右键点击该标签页并选择 拆分并右移 或 拆分并下移。 当组包含多个标签页时,这些选项可用。

  • 或者,将标签页拖动到 终端 工具窗口的任意边缘。 RubyMine 会高亮显示新组出现的区域。 要将标签页移动到现有组,请将其拖动到该组的标签页页眉。

  • 要在组之间移动焦点,请点击某个组,或转到 窗口 | 活动工具窗口 | Go 到下一个拆分器 (⌥ ⇥ )或 转到上一个分割器 (⌥ ⇧ ⇥)。

  • 要合并拆分的标签页组,请右键点击标签页并选择 不分割。 如果之前多次拆分了工具窗口,请对每个拆分重复该操作。 或者,将某个组的所有标签页拖动到另一个组的标签页页眉。 当关闭或移动某个组的最后一个标签页时,该组会被自动移除。

在编辑器中打开终端标签页

可以将标签页从 终端 工具窗口移动到编辑器区域,并将其用作常规编辑器标签页。

  • 右键点击 终端 工具窗口中的选项卡,然后选择 作为编辑器标签页打开 (Alt+Shift+Enter ),或将该选项卡拖到编辑器区域。

    如果移动工具窗口中的最后一个标签页, 终端 工具窗口会自动隐藏。

  • 要将标签页移回,请在编辑器中右键点击它并选择 返回工具窗口 ,或将其拖动到 终端 工具窗口。

这会使会话占用编辑器区域的完整高度,有助于查看长时间运行命令的输出或使用 CLI 编码代理。 标签页移动时,会话会继续运行,因此命令历史记录和输出会被保留。

要让 终端 工具窗口浮动在 IDE 上方,或将其移动到单独的窗口,请更改其 视图模式。

终端引擎

当前,RubyMine 中可用的终端引擎包括:

  • 改进版(默认). 从 2025.2 版本开始,这是 RubyMine 中的默认终端引擎。它旨在结合 Classic 模拟器的稳定性以及改进的性能、兼容性和现代增强功能。 它旨在结合 Classic 模拟器的稳定性以及改进的性能、兼容性和现代增强功能。

  • Classic. 这是上一代的标准终端模拟器,基于 JediTerm 库构建,用户输入(命令和按键)会直接发送到底层 shell。

实验性 2024(已弃用) 终端引擎,也被称为 RubyMine 2024.* 中的 New Terminal,因兼容性问题已被弃用。 仅在 RubyMine 2024.* 中曾启用该终端引擎的用户可以选择此终端引擎。 您可以在 RubyMine 帮助的早期版本 中找到其文档。

选择终端引擎

  1. 打开 终端 工具窗口: 视图|工具窗口|终端。

  2. 在工具窗口标题中,点击 选项 并选择一个终端引擎。

    终端选择引擎

    或者,打开 IDE 设置(Ctrl+Alt+S )并进入 工具 | 终端 | 终端引擎。

配置终端

配置终端仿真器

  • 按 Ctrl+Alt+S 打开设置,然后选择 工具 | 终端。

  • 或者,点击 ,然后选择 设置。

欲了解更多信息,请参阅 终端设置。

配置已执行命令之间的分隔符

为了更清晰地区分命令的起始位置,您可以在终端中启用分隔符。

  1. 按 Ctrl+Alt+S 打开设置,然后选择 工具 | 终端。

  2. 使用 显示已执行命令之间的分隔符 选项启用或禁用分隔符。

    命令分隔符已启用
    命令分隔符已禁用
  3. 请点击 Apply 以保存更改。

2026年 11月 9日