RubyMine 2025.2 Help

运行/调试配置

RubyMine 使用运行/调试配置来运行、调试、部署和测试您的代码。 每个配置是一组命名的启动属性,用于定义要执行的内容以及应使用的参数和环境。

您可以根据您的需求自定义配置参数,例如:

  • 对于 Rails 运行/调试配置,您可以指定服务器类型(例如 Puma 或 Passenger)、IP 地址和端口、环境(默认是 development )等。

  • 对于 Ruby 运行/调试配置,您可以定义命令行参数、传递所需的环境变量等。

  • 对于 RSpec ,您可以选择包含所需测试的文件夹并提供自定义运行选项。

让我们看看如何一般性地使用运行/调试配置——从创建临时配置到通过 VCS 共享配置。

有两种 运行/调试 配置:

  • 临时——每次运行 Ruby 脚本Rails 服务器测试 或其他未配置的命令时创建。

  • 永久—由模板显式创建或通过保存临时配置创建。 永久配置将作为您项目的一部分,直到您删除它们。

每当您运行、调试或测试代码时,RubyMine 要么使用现有的永久运行/调试配置,要么创建一个新的临时配置。

永久配置的图标是不透明的,而临时配置的图标是半透明的。 配置图标上的红色叉号表示配置设置中存在错误。

永久配置和临时配置有不同的图标

临时配置的最大数量为 5。 添加新版本时,旧版本会被自动删除。 如有必要,您可以在 设置 | 高级设置 | 运行/调试 | 临时配置限制 中增加此限制。

创建永久运行/调试配置

RubyMine 提供以下方法来创建永久运行/调试配置:

将临时配置保存为永久配置

  • 在 运行/调试 配置切换器中选择一个临时配置,点击 并选择 保存配置

    编辑运行配置
  • 或者,在“运行/调试配置”对话框中选择一个临时配置,然后点击工具栏上的 保存

RubyMine 为不同的语言、工具和框架提供运行/调试配置 模板。 可用模板的列表会因已安装和启用的 plugins 而有所不同。

从模板创建运行/调试配置

  1. 转到 运行 | 编辑配置。 或者,按 Alt+Shift+F10 ,然后 0

  2. 运行/调试配置 对话框中,点击工具栏上的 或按 Alt+Insert。 该列表显示运行/调试配置模板。

    新建运行/调试配置
  3. 对于新的运行/调试配置,请指定以下设置:

    运行/调试配置:Rails
    • 名称 :指定配置名称。

    • 允许并行运行 :如果启用此选项,您可以多次并行启动运行配置,而不是重新运行它。 每个运行器将在运行或调试工具窗口的自己的选项卡中启动。

    • 存储为项目文件 :启用此选项以 将您的配置保存为项目文件 ,并通过 VCS 与团队成员共享。

    • 配置特定于所选配置类型的设置(例如, RubyRailsRSpec)。

    • 启动前 :在此区域,您可以指定必须在 运行之前 执行的任务。

    • 显示此页面 :启用此选项以在实际启动运行/调试配置之前显示其设置。

    • 激活工具窗口 :使用此选项指定在启动运行/调试配置时是否打开运行/调试工具窗口。

  4. 您可以立即运行该配置,也可以保存配置以便稍后运行。

    • 要保存运行配置以供稍后运行,请单击 确定

    • 若要立即运行此配置,请点击 运行

共享运行/调试配置

您可能希望共享您的 运行/调试 配置,以便您的团队成员可以使用相同的配置运行应用程序,或者使他们能够远程附加到您正在运行的进程。

RubyMine 提供了一种机制,可以将您的 运行/调试 配置存储为项目文件并通过 VCS 共享。 当您希望将配置作为文件发送给其他人、创建运行/调试配置的本地备份或从文件导入它们时,也可以使用相同的机制。

传统 .ipr -based 项目不支持单独的 运行/调试 配置。 对于传统项目,您只能通过将 .ipr 文件添加到 VCS 来一次性共享所有配置。

  1. 转到 运行 | 编辑配置。 或者,按 Alt+Shift+F10 ,然后 0

  2. 请选择您要共享的 运行/调试 配置,启用 存储为项目文件(S) 选项,并指定配置文件的存储位置。

    您可以配置任何位置,除非需要与 RubyMine 2019.3 及更早版本兼容。 为了与这些版本兼容,请将文件存储在建议的位置。

  3. (可选)如果将 .idea 目录添加到 VCS 忽略文件中,那么 .idea/runConfigurations 子文件夹也将被忽略。 如果项目使用 Git,您可以共享 .idea/runConfigurations 并保留 .idea 被忽略,通过修改 .gitignore 如下:

    /.idea/* !/.idea/runConfigurations

运行/调试配置模板

所有运行/调试配置都基于模板,这些模板实现了启动逻辑,定义参数列表及其默认值。 安装中预定义了 可用模板列表 ,只能通过 插件进行扩展。 但是,您可以编辑每个模板中的默认参数值,以便于新运行/调试配置的设置。

配置模板的默认值

  1. 转到 运行 | 编辑配置。 或者,按 Alt+Shift+F10 ,然后 0

  2. 在 运行/调试 配置对话框的左侧窗格中,点击 编辑配置模板…

    编辑配置模板
  3. 在打开的 运行/调试配置模板 对话框中,选择一个配置类型。

    运行/调试模板
  4. 请指定所需的默认参数,然后点击 确定 以保存模板。

运行/调试配置文件夹

当有许多相同类型的 运行/调试 配置时,您可以将它们分组到文件夹中以便于访问。

运行配置的文件夹

为运行/调试配置创建一个文件夹

  1. 转到 运行 | 编辑配置。 或者,按 Alt+Shift+F10 ,然后 0

  2. 运行/调试配置 对话框中,选择配置类型并在工具栏上点击 新建文件夹图标。 已创建一个新的空文件夹用于所选类型。

  3. 请在右侧的文本框中指定文件夹名称或接受默认名称。

  4. 选择所需的 运行/调试 配置并将它们移动到目标文件夹下。

  5. 应用这些更改。 如果一个文件夹是空的,它将不会被保存。

当您不再需要文件夹时,可以将其删除 Delete。 此文件夹下的 运行/调试 配置将被移动到相应 运行/调试 配置类型的根目录下。

在启动运行/调试配置之前执行任务

大多数类型的运行/调试配置都有 启动前 部分,您可以在其中指定在执行配置之前必须完成的任务。 例如,您可以在运行测试配置之前运行 db:prepare Rake 任务。

要添加任务,请展开 启动前 部分,单击 Add Add ,选择所需的任务类型,并在需要时指定其参数。

您可以在启动运行/调试配置之前执行以下任务:

启动 Web 浏览器

在选定的 浏览器 中打开指定的 URL。

运行外部工具

启动在 外部工具 中配置的另一个应用程序。 在打开的对话框中,选择您要运行的一个或多个应用程序。

运行另一个配置

启动另一个运行/调试配置。 与 复合 配置不同,这种运行多个配置的方式允许您定义配置启动的顺序。

运行文件监视器

应用所有当前活动的 文件监视器

运行远程外部工具

执行 远程 SSH 外部工具

运行 Grunt 任务

运行 Grunt 任务

运行 gulp 任务

运行 Gulp 任务

运行 npm 脚本

执行 npm 脚本

编译 TypeScript

运行内置的 TypeScript 编译器,从而确保您对 TypeScript 代码所做的所有更改都反映在生成的 JavaScript 文件中。 在打开的 TypeScript 编译设置 对话框中,选择或清除此 检查错误 复选框,以配置编译器在检测到错误时的行为:

  • 如果选中了 检查错误 复选框,编译器会显示所有错误,并且运行配置将不会启动。

  • 如果清除了 检查错误 复选框,编译器将显示所有检测到的错误,但运行配置仍将启动。

生成 CoffeeScript 源地图

为您的 CoffeeScript 源生成源映射。 在打开的对话框中,指定您的 CoffeeScript 源文件所在的位置。

运行 Shell 脚本

运行指定的 Shell 脚本。 请注意,您需要 创建Shell 脚本 配置。

运行 Rake 任务

添加一个 Rake 任务 ,以在运行或调试之前执行。

运行 JRuby 编译器

使用指定的目标路径、编译器进程堆大小和命令行参数(如果有)执行 JRuby 编译器。

最后修改日期: 2025年 9月 26日