llms.txt: machine-readable documentation index. Markdown version of this page is also available.

CLion 2026.3 Help

从命令行运行代码检查

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

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

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

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

检查 C:\MyProject\src 目录,该目录位于 C:\MyProject 项目中,使用最大详细程度的 C:\MyProject\.idea\inspectionProfiles\MyProfile.xml 配置文件,并将结果保存到 C:\MyProject\InspectionResults 下的 XML 文件:

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

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

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

检查 ~/MyProject/src 目录,该目录位于 ~/MyProject 项目中,使用最大详细程度的 ~/MyProject/.idea/inspectionProfiles/MyProfile.xml 配置文件,并将结果保存到 ~/MyProject/InspectionResults 下的 XML 文件:

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

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

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

检查 ~/MyProject/src 目录,该目录位于 ~/MyProject 项目中,使用最大详细程度的 ~/MyProject/.idea/inspectionProfiles/MyProfile.xml 配置文件,并将结果保存到 ~/MyProject/InspectionResults 下的 XML 文件:

clion.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 配置目录下 inspection 。

检查结果

您可以在 CLion 或任何文本编辑器中将生成的 XML 文件作为常规文件打开。 但是,使用 离线视图 (位于 问题工具窗口 )进行分析更方便:

查看检查结果

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

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

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

2026年 11月 6日