IntelliJ IDEA 2025.2 Help

从命令行运行代码检查

IntelliJ IDEA 运行代码检查以查找和突出显示语法错误、无用代码、可能的错误、不良编码风格和其他问题。 您还可以从命令行运行为特定项目配置的所有检测,并将结果存储为报告的 XML、JSON 或纯文本文件。

命令行检查器将在后台启动 IntelliJ IDEA 实例,并在其中运行检查。 如果另一个 IntelliJ IDEA 实例已经在运行,则无法工作。 在这种情况下,您可以在运行实例中使用检查。 使用命令行检查器对有众多贡献者的大型项目进行自动化常规代码分析。

您可以在 bin 下的安装目录中找到运行 IntelliJ IDEA 的可执行文件。 要将此可执行文件用作命令行启动器,请按 PATH 中所述将其添加到您的系统中 命令行界面

语法
idea64.exe inspect <project> <inspection-profile> <output> [<options>]
示例

请使用 C:\MyProject\.idea\inspectionProfiles\MyProfile.xml 配置文件以最大详细信息级别检查 C:\MyProject\src 目录下的 C:\MyProject 项目,并将结果保存到 C:\MyProject\InspectionResults 下的 XML 文件中:

idea64.exe inspect C:\MyProject C:\MyProject\.idea\inspectionProfiles\MyProfile.xml C:\MyProject\InspectionResults -v2 -d C:\MyProject\src

IntelliJ IDEA 包含一个用于运行命令行代码检查器的脚本。 默认情况下,它位于应用程序包中: IntelliJ IDEA Ultimate.app/Contents/bin/inspect.sh

语法
inspect.sh <project> <inspection-profile> <output> [<options>]
示例

请使用 ~/MyProject/.idea/inspectionProfiles/MyProfile.xml 配置文件以最大详细信息级别检查 ~/MyProject/src 目录下的 ~/MyProject 项目,并将结果保存到 ~/MyProject/检查结果 下的 XML 文件中:

inspect.sh ~/MyProject ~/MyProject/.idea/inspectionProfiles/MyProfile.xml ~/MyProject/InspectionResults -v2 -d ~/MyProject/src

您可以在 bin 下的安装目录中找到运行 IntelliJ IDEA 的脚本。 要将此脚本用作命令行启动器,请按照 命令行界面 中描述的方式将其添加到您的系统 PATH

语法
idea.sh inspect <project> <inspection-profile> <output> [<options>]
示例

请使用 ~/MyProject/.idea/inspectionProfiles/MyProfile.xml 配置文件以最大详细信息级别检查 ~/MyProject/src 目录下的 ~/MyProject 项目,并将结果保存到 ~/MyProject/检查结果 下的 XML 文件中:

idea.sh inspect ~/MyProject ~/MyProject/.idea/inspectionProfiles/MyProfile.xml ~/MyProject/InspectionResults -v2 -d ~/MyProject/src

选项

选项

描述

-changes

仅运行在本地未提交更改上的检查。

-d

如果您不想检查整个项目,请指定子目录的完整路径。

-format

指定输出文件的检查结果格式: xml (默认), json ,或 plain

-v

设置输出的详细程度:

  • -v0 是默认的低冗长度。

  • -v1 是中等详细级别。

  • -v2 是最大详细级别。

检查配置文件

一个 检查配置文件是一个 .xml 文件,用于指定启用的检查及其选项。

默认情况下, 项目检查配置文件 存储在项目目录: .idea/inspectionProfiles

全局 IDE 检查配置文件存储在 IDE 配置目录 检查

检查结果

您可以在 IntelliJ IDEA 或任何文本编辑器中将生成的 XML 文件作为常规文件打开。 然而,使用 离线查看 “问题”工具窗口 进行分析更为方便:

查看检查结果

  1. 打开您运行检查的项目。

  2. 在主菜单中,进入 代码 | 分析代码 | 查看离线检查结果

  3. 请选择包含检查结果的目录,然后点击 OK

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