RuboCop

IntelliJ IDEA 支持与 RuboCop 集成，并使您能够直接在 IDE 中（例如，在代码编辑器中）修复其违规行为。

您还可以检查整个项目，并在一份报告中显示所有 RuboCop 警告。

如果必要，您可以启用 Standard包装器并使用它来分析项目源代码。

安装 RuboCop/Standard gems

默认情况下， RuboCop 检查在 IntelliJ IDEA 中启用，并且需要在项目的解释器中安装 'rubocop' gem。如果该 gem 未安装，IntelliJ IDEA 会建议这样做。

如果您想使用 Standard 分析您的项目，请将 'standard' gem 添加到您的 Gemfile 并安装它。

启用或禁用 RuboCop 和标准检查，请执行以下操作：

当启用 RuboCop 检查时，IntelliJ IDEA 会在代码编辑器中突出显示其违规行为。要查看警告说明并进行修复，请执行以下操作：

IntelliJ IDEA 使您能够通过运行相应的检查来查找整个项目中的 RuboCop 违规。为此，请按照以下步骤操作：

按 Ctrl+Alt+Shift+I 或转到主菜单中的代码 | 分析代码 | 通过名称运行检查(R)…。
在弹出窗口中，找到 RuboCop 并按 Enter。
在运行 'RuboCop' 对话框中，指定您要分析的文件范围。如果有必要，启用请使用‘standard’ gem。点击 OK。
请等待 IntelliJ IDEA 分析您的项目。在检查结果工具窗口中，您可以查看 RuboCop 违规，并使用修复所有可自动更正的 RuboCop 问题按钮修复可自动更正的违规。
您还可以浏览单个文件，并根据类错误或警察部门应用特定修复。

您可以配置 IntelliJ IDEA 在每次保存更改时自动启动 RuboCop 并在安全模式下自动修复代码。

默认情况下，IntelliJ IDEA 按如下方式映射 RuboCop 严重性和检查严重性：

要更改默认映射，请按照以下步骤操作：

RuboCop 允许您通过配置文件自定义其行为。 IntelliJ IDEA 会自动检测 .rubocop.yml 文件并使用它运行检查。或者，您可以为检查指定自定义配置文件。

IntelliJ IDEA 会考虑 .rubocop.yml 文件中指定的所有设置。例如，如果您禁用某些检测，指定 cop 部门，编辑器将不会显示相应的违法行为。此外，这些违规行为不会显示在 RuboCop 检查报告中。

要指定自定义 RuboCop 配置文件：

如果未选择配置文件，检查将使用项目中存在的 .rubocop.yml 运行。否则，IntelliJ IDEA 将使用默认设置。

有时需要使用自定义选项运行 RuboCop 以检查当前打开的文件。例如，当 RuboCop 检查被禁用时，或者您想为某个特定的 RuboCop 操作分配一个快捷键。

在这个示例中，我们将展示如何使用 RuboCop 作为外部工具来纠正当前打开文件中的布局违规。

在设置对话框（Ctrl+Alt+S ）中，选择工具 | 外部工具。
点击并指定以下设置：
- 名称：将在 IntelliJ IDEA 界面中显示的菜单命令（工具菜单和上下文菜单）。
- 分组：该命令所属组的名称。您可以选择一个现有组或输入一个新组名。
- 程序：RuboCop 可执行文件的名称。
- 实参：传递给可执行文件的参数，就像您在命令行中指定它们一样。这里我们使用 -x RuboCop 选项仅检查当前文件的布局问题。
- 工作目录：从执行工具的当前工作目录的路径。
点击 OK 添加工具，然后应用更改。
（可选）为新建的操作分配一个快捷键。在设置对话框(Ctrl+Alt+S )中, 选择按键映射, 在 RuboCop 节点下找到外部工具操作并指定一个快捷键。

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