CLion 2018.3 Help

Run Inspections

Although code analysis is performed on-the-fly in all open files, you may want to run it for the whole project or a custom scope and examine the results in a friendly view.

Run a code inspection

  1. Open the desired file in the editor. Alternatively select files or directories in the Project Tool Window. For multiple selection, click the items holding down the Ctrl/ key. The initial inspection scope will be confined to the opened file or the selection.

  2. On the main menu, choose Code | Inspect Code. The Specify Inspection Scope dialog box opens.

  3. In the Inspection scope area, specify which files should be inspected.
    • To have the source code of the entire project inspected, select the Whole Project option.

    • If you are using version control integration, you can choose to only inspect uncommitted files.

    • To run an inspection for the currently opened file, or the file(s)/folder(s) selected in the Project view, select the File/Module <name> option.

    • To apply inspect code in a specific scope, select the Custom scope option, then choose the desired scope from the drop-down list or click Browse browseButton and configure a new scope in the Scopes dialog box.

  4. To have test source files inspected too, select the Include test sources check box.

  5. Specify the inspection profile to apply. Do one of the following:
  6. Click OK to run code analysis.

  7. Examine results in the Inspection Results Tool Window.

It is also possible to run inspections offline, without starting the IDE. Follow the procedure described in the section Working with CLion Features from Command Line.

Rather than running all enabled inspections, CLion makes it possible to exactly specify the desired inspection by its name and run it to inspect the code in the specific scope.

Run inspection by name

  1. Open the desired file in the editor. Alternatively select files or directories in the Project Tool Window. For multiple selection, click the items holding down the Ctrl/ key. The initial inspection scope will be confined to the opened file or the selection.

  2. On the main menu, choose Code | Run Inspection by Name, or press Ctrl+Shift+Alt+I.

  3. In the pop-up frame that opens, start typing the inspection name. As you type, the suggestion list shrinks to show the matching inspection only.

    If you are not sure that you are selecting the correct inspection, you can view its description. To do so, select an inspection in the popup and press Ctrl+Q.

    cl inspectionByName
    The Specify Inspection Scope dialog box opens.
  4. In the Inspection scope area, specify which files should be inspected.
    • To have the source code of the entire project inspected, select the Whole Project option.

    • If you are using version control integration, you can choose to only inspect uncommitted files.

    • To run an inspection for the currently opened file, or the file(s)/folder(s) selected in the Project view, select the File/Module <name> option.

    • To apply inspect code in a specific scope, select the Custom scope option, then choose the desired scope from the drop-down list or click Browse browseButton and configure a new scope in the Scopes dialog box.

  5. To have test source files inspected too, select the Include test sources check box.

  6. To apply inspection only in files matching the specific mask, select the File Masks(s) and specify the file mask. Use comma to separate multiple file masks.

  7. Click OK to run the inspection.

  8. Examine results in the Inspection Results Tool Window.

Last modified: 7 December 2018

See Also