IntelliJ IDEA 2025.1 Help

运行/调试配置:Rails

Rails 运行/调试配置使您能够在选定的环境中执行 Rails applications。

前提

在开始使用 Ruby 之前,请确保 Ruby 插件已 安装并启用。 按下 Ctrl+Alt+S ,前往 插件 并查看 已安装 选项卡,以确保插件已启用。

同时,请确保满足以下先决条件:

  • Ruby SDK 已下载并安装在您的机器上。

  • 所需的框架SDK已经下载并安装到您的机器上。

有关更多信息,请参阅各自的下载和安装页面:

配置选项卡

条目

描述

服务器

指定一个用于运行 Rails 应用程序的 Web 服务器。 您可能需要为项目解释器安装相应的 gem(例如, Puma 、 Passenger (mod_rails) 等)。 您可以在此处找到支持的 Rails 服务器的完整列表: 支持的 Ruby 相关技术版本。

IP 地址

指定可以访问 Rails 服务器 的 IP 地址。

如果您使用 Puma 与 unix socket binding 运行您的应用程序,则无需指定服务器的 IP 地址。 如果未提供该值,IntelliJ IDEA 在运行 -b <IP Address> 选项时将忽略 rails server 命令。

如果没有提供 IP 地址,则无法使用 HTML 和 ERB 文件的 browser preview。

端口

指定运行 Rails 服务器的端口。

如果您使用 Puma 和 unix socket 绑定来运行您的应用程序,则无需指定服务器的端口。 如果未提供该值,IntelliJ IDEA 在运行 -b <IP Address> 选项时将忽略 rails server 命令。

如果未提供端口,HTML 和 ERB 文件的 browser preview不可用。

服务器实参

输入可选的服务器参数。 您可以在 终端模拟器 中运行 rails server --help 命令以了解更多可用参数。

环境

请选择运行服务器所需的 Rails 环境(开发、 生产环境 或 测试)。

虚拟应用

此字段仅对 Rails 可挂载引擎项目启用。 请指定 dummy 目录的绝对路径。 此路径是运行引擎所必需的。

运行浏览器

选择此选项可在默认浏览器中自动打开应用程序。

如果启用该选项,请提供浏览器 URL 以确保 IntelliJ IDEA 不会运行 JS 调试器。

调试时自动启动 JavaScript 调试器

启用此选项以 启动 JavaScript 调试器。

环境变量

请指定环境变量列表为名称-值对,用分号分隔。 或者,点击 浏览按钮 在 环境变量 对话框中创建变量并指定它们的值。

Ruby 实参

指定要传递给 Ruby 解释器的 command-line arguments。

Ruby 解释器

指定所需的 Ruby 解释器。 您可以选择项目默认的 Ruby 解释器,或者从已配置的 Ruby 解释器列表中选择一个不同的。

Bundler 选项卡

条目

描述

在捆绑包的上下文中运行脚本(‘bundle exec')

使用 Bundler 运行脚本可确保使用 Gemfile 中指定的 gem 版本。 请选择一个选项:

  • 自动检测 :选择此选项以在可能的情况下使用 bundle exec 运行您的代码。

  • 已禁用 :选择此选项以禁用 bundle exec 的使用。

代码覆盖率选项卡

使用此选项卡配置 代码覆盖率监控选项。

条目

描述

要包含在覆盖数据中的包和类

点击 "添加"按钮 并选择 添加类按钮添加类 或 “ 添加包按钮 ”添加软件包 以指定要测量的类和包。 您还可以通过在列表中选择类和包,然后点击 删除这个包 按钮从列表中删除它们。

要从覆盖率数据中排除的包和类

点击 "添加"按钮 并选择 添加类按钮添加类 或 “ 添加包按钮 ”添加软件包 来指定不应当被测量的类和包。 您还可以通过在列表中选择类和包,然后点击 删除这个包 按钮从列表中删除它们。

日志标签

使用此选项卡指定运行或调试时生成的日志文件应显示在控制台上,即 Run 或 Debug(调试)工具窗口 的专用选项卡上。

条目

描述

处于活动状态

选中此列中的复选框以在 运行工具窗口 或 Debug(调试)工具窗口 中显示日志条目。

日志文件条目

此列中的只读字段列出了要显示的日志文件。 列表可以包含:

  • 特定文件的完整路径。

  • Ant 模式定义要显示的文件范围。

  • 用于替代完整路径或模式的别名。 这些别名也显示在选项卡的标题中,对应的日志文件在其中显示。

    如果日志条目模式定义了多个文件,选项卡标题将显示文件名而不是日志条目别名。

跳过内容

选中此复选框以跳过所选日志的先前内容。

将控制台输出保存到文件

选择此复选框以将控制台输出保存到指定位置。 请手动输入路径,或点击浏览按钮并指向 打开的对话框中的所需位置。

在消息打印到标准输出流时显示控制台

选中此复选框以激活输出控制台,并在关联进程写入 Standard.out 时将其前置。

在消息打印到标准错误流时显示控制台

选中此复选框以激活输出控制台,并在相关进程写入 Standard.err 时将其置于前端。

"添加"按钮

点击此按钮以打开 编辑日志文件别名对话框 ,在此对话框中您可以选择一个新的日志条目并为其指定别名。

编辑按钮

点击此按钮以在 编辑日志文件别名对话框中编辑所选日志文件条目的属性。

删除按钮

点击此按钮从列表中删除所选日志条目。

通用设置

当您编辑运行配置(但不是运行配置模板)时,您可以指定以下选项:

条目

描述

名称(N)

在编辑或运行时,指定运行配置的名称以便快速识别。

允许多个实例(U)

允许并行运行此运行配置的多个实例。

默认情况下,它是禁用的,当您在另一个实例仍在运行时启动此配置,IntelliJ IDEA 建议停止正在运行的实例并启动另一个。 当一个运行配置消耗大量资源且没有充分理由运行多个实例时,这会很有帮助。

存储为项目文件(S)

将运行配置设置的文件保存下来,与其他团队成员共享。 默认位置是 .idea/runConfigurations 。 但是,如果您不想共享 .idea 目录,您可以将配置保存到项目内的任何其他目录。

默认情况下,它是禁用的,并且 IntelliJ IDEA 将运行配置设置存储在 .idea/workspace.xml 。

工具栏

运行/调试配置的树状视图包含一个工具栏,可帮助您管理 项目 中可用的配置以及调整默认配置模板。

条目

快捷键

描述

"添加"按钮

Alt+Insert

创建运行/调试配置。

"移除"按钮

Alt+Delete

删除所选的运行/调试配置。 请注意,您不能删除默认配置。

复制

Ctrl+D

创建所选运行/调试配置的副本。 请注意,您正在创建默认配置的副本。

保存配置

只有当您选择了 temporary configuration时,按钮才会显示。 点击此按钮将临时配置保存为永久配置。

移动到新文件夹/创建新文件夹

移动到新文件夹/创建新文件夹。 您可以通过 将它们放入文件夹来分组运行/调试配置。

要创建文件夹,请选择类别中的配置,点击 文件夹 ,并指定文件夹名称。 如果只有一个类别处于焦点,则会创建一个空文件夹。

然后,若要将配置移动到文件夹中、文件夹之间或从文件夹中移出,请使用拖放或 上移 与 下移 按钮。

要取消分组,请选择一个文件夹并点击 移除配置。

排序配置

点击此按钮以按字母顺序排列配置。

启动前

在此区域,您可以指定在启动所选的运行/调试配置之前需要执行的任务。 任务将按其在列表中出现的顺序执行。

条目

快捷键

描述

"添加"按钮

Alt+Insert

点击此图标以添加以下可用任务之一:

  • 启动Web 浏览器 :选择此选项以启动浏览器。 在打开的对话框中,选择浏览器类型并提供起始 URL。 此外,指定是否希望浏览器与 JavaScript 调试器一起启动。

  • 运行外部工具 :选择运行外部应用。 在打开的对话框中,选择您想要运行的一个或多个应用程序。 如果它在 IntelliJ IDEA 中尚未定义,请添加其定义。 如需更多信息,请参阅 外部工具 和 外部工具设置。

  • 运行另一个配置 :选择执行另一个运行/调试配置,并等待其完成后再启动当前配置。 如果您想并行运行多个配置,请使用 compound run/debug configuration。

  • 构建 :选择编译指定的模块。 Build Module命令 将会被执行。

    如果在编译过程中发生错误,IntelliJ IDEA 将不会尝试启动运行/调试配置。

  • 构建项目 :选择编译整个项目。 Build Project 命令 将被执行。

    如果在编译过程中发生错误,IntelliJ IDEA 将不会尝试启动运行/调试配置。

  • 构建,不检查错误 :与 构建 选项相同,但 IntelliJ IDEA 将会尝试启动运行/调试配置,而不考虑编译结果。

  • 构建物 :选择此选项以构建一个或多个 构件。 在打开的对话框中,选择应构建的 artifact。

  • 运行Grunt 任务 :选择此选项以运行 Grunt 任务。

    在打开的 Grunt 任务 对话框中,指定定义所需任务的 Gruntfile.js ,选择要执行的任务,并指定传递给 Grunt 工具的参数。

    指定 Node.js 解释器的位置、传递给它的参数以及 grunt-cli 包的路径。

  • 运行gulp 任务 :选择此选项以运行 Gulp 任务。

    在打开的 Gulp 任务 对话框中,请指定定义所需任务的 Gulpfile.js ,选择要执行的任务,并指定传递给 Gulp 工具的参数。

    指定 Node.js 解释器的位置、传递给它的参数以及 gulp 包的路径。

  • 运行 Maven Goal :选择此选项以 运行一个 Maven 目标。 在打开的对话框中,选择要运行的目标。

  • 运行npm 脚本 :选择此选项以执行 npm script。

    在打开的 NPM 脚本 对话框中,指定 npm 运行/调试配置设置。

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

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

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

  • 将文件上传到远程主机 :选择此选项以根据 默认服务器访问配置自动 上传应用程序文件到服务器。

  • 运行远程外部工具 :添加一个 远程 SSH 外部工具。

  • 断开数据源 :如果您希望在运行/调试配置运行之前中断与数据源的连接,请选择此选项。

"移除"按钮

Alt+Delete

点击此图标以从列表中删除所选任务。

编辑

Enter

点击此图标以编辑所选任务。 在打开的对话框中进行必要的更改。

方法 up

方法 down

Alt+Up

Alt+Down

点击这些图标可以将所选任务在列表中上下移动一行。 任务按照它们在列表中出现的顺序执行。

显示此页面

选中此复选框,以在实际启动运行/调试配置之前显示运行/调试配置设置。

激活工具窗口

默认情况下,将选中此复选框,启动运行/调试配置时将打开 Run 或 Debug 工具窗口。

否则,如果复选框被清除,工具窗口将被隐藏。 但是,当配置运行时,您可以通过按 Alt+4 或 Alt+5 自行打开相应的工具窗口。

最后修改日期: 2025年 4月 24日