CLion 2021.2 Help

Advanced settings

Besides standard settings options that you frequently use, CLion offers various advanced options that you can use to fine-tune the behavior of the specific product functionality.

Since the advanced settings consist of different sections, you can use the search field to quickly navigate to the section of interest or the needed option. You can also search for registry keys since some of advanced options have associated registry keys.

CMake

Use this section to configure additional options for CMake projects.

ItemDescription
Do not trigger CMake reload on external changes if auto-reload is disabledSelect this option to completely disable automatic reload of CMake projects including external changes. See Load/reload CMake.
Perform initial profile configuration when a project is opened for the first timeClear this checkbox if you prefer CLion not to automatically configure and show a default CMake profile when you open a project for the first time.

Clangd

Use this section to configure additional options for the Clangd engine.

ItemDescription
Use global Clangd completion cacheClean this checkbox if you prefer CLion not to use Clangd's global cache when performing code completion with Clangd. Disabling the completion cache can help reduce memory consumption and avoid unexpected crashes.

Editor

Use this section to configure additional options for working with code in the editor.

ItemDescription
Don't copy/cut the current line when invoking the Copy or Cut action with no selectionIf you select this option, CLion will not copy or cut a line if it is not selected. In this case, you can avoid the unexpected behavior if you accidentally press Ctrl+C or Ctrl+X.
Render special characters, such as control codes, using their Unicode name abbreviationsWhen this option is selected, you can use the Unicode name abbreviations for special characters, such as control codes.
Tab character rendering

You can select one of the following options:

  • Horizontal line

  • > symbol

  • Long arrow

Left margin in distraction free modeIf you specify -1, CLion will automatically calculate the margin and center the editor.
Force soft wrap in documents with lines longer than n charactersThe default number is 100000. Increasing this number might negatively affect the editor performance.
Move caret down after Comment with Line Comment actionWhen this option is selected, you can use Ctrl+/ to move the caret down after the comment.

Editor Tabs

Besides the standard editor tabs options that CLion offers when you work with tabs in the editor, this section contains extra options that are also available as internal registry actions.

ItemDescription
When navigating to a file, prefer selecting existing tab in inactive split paneWhen you navigate to a file that is already opened in the inactive split, use this option to activate the existing file in that split pane instead of opening a new copy of the file in the active split.
Open declaration source in the same tabWhen you navigate to a method, class or variable, the source file that contains their declaration will replace the current tab if there are no changes.
Open declaration source called from a detached window in the main IDE windowWhen you navigate to a method, class, or variable from a detached window, CLion will open the source file containing the declaration in the main editor.
Perform 'Hide All Tool Windows' / 'Restore Windows' with double-click on editor tabThis option toggles hiding and restoring all tool windows when you double-click the editor tab.
Perform 'Maximize Editor' / 'Normalize Splits' with double-click on editor tabThis option toggles maximizing the editor and restoring the splits when you double-click the editor tab.

Find / Replace

Use this section to configure extra options when working with Find and replace in project.

ItemDescription
Maximum number of results to show in Find in Path/Show Usages previewThe default maximum number of results is 100. Increasing this limit might significantly increase memory usage.

IDE

Use this section to configure extra options on storing different entities of your project.

ItemDescription
Maximum number of recent projectsUse this option to change the default number of stored recent projects, which is 50.
Maximum number of recent filesUse this option to change the default number of stored recent files, which is 50.
Maximum number of recent locationsUse this option to change the default number of stored recent locations, which is 25.
Temporary Run/Debug configurations limitUse this option to change the default number of stored temporary run/debug configurations, which is 5.
Duration of storing changes in Local HistoryUse this option to specify the number of days for which you want to keep changes in the local history.

Makefile

Use this section to configure additional options for Makefile projects.

ItemDescription
Implicit Make output analyzer options

In this field, you can edit the Make output analyzer flags.

For example, if you remove the --just-print option, your project will be analyzed and built in a single pass. However, this can cause performance issues. Also, in this case the command output and Make output will be mixed, which can affect the analyzer accuracy.

Save Make output to log files...Set this checkbox to collect the Make output logs.
Use POSIX shell parser on MinGW toolchain (Windows)If you are working on Windows with MinGW, you can set this checkbox to switch from Windows batch to the POSIX shell parser.

Project View

Use this section to configure additional options for working in Project tool window.

ItemDescription
Move focus to editor when Enter is pressedWhen this option is selected, you can press Enter while in the Project view to switch focus to the editor.
When collapsing a node, also collapse all expanded nodes under itWhen this option is selected, CLion collapses subnodes as well as the parent node.
Increase font size in Project viewSelect this option if you want to change the size of font in the Project view. You need to restart CLion.

Python

ItemDescription
Pytest: swap actual/expected in diffBy default, CLion provides the expected == actual pytest assertion. Select this checkbox to change the order of the assertion parameters to actual == expected.
Pytest: don't add "--no-header --no-summary -qUse this checkbox to manage the test output generated by pytest. Select it to keep rendering the header and summary.

Startup

ItemDescription
Open README.md file if there are no open files on project startupIf you select this option, CLion will open a README.md file if there aren't any opened files when you start your project.

Terminal

ItemDescription
Terminal scrollback buffer sizeUse this option to increase the buffer size in the terminal.
Move focus to the editor with EscapeWhen this option is selected, you can use Escape to switch focus from the terminal to the editor.

User Interface

ItemDescription
Show file type icon in IDE frame headerOn macOS, the icon can be used to drag a file to a different application.
Cyclic scrolling in lists and treesSelect the last element when pressing Up on the first element, and vice versa.
Position mouse cursor on default button in dialogsWhen this option is selected, the mouse cursor is placed on the default button (usually it is OK) in a dialog.
Disable double modifier key shortcutsYou can disable shortcuts where a double key is used. For example, Shift or Ctrl.

Version Control

ItemDescription
Open Diff as Editor TabWhen this option is selected, the difference viewer is displayed as the editor tab.
Load file annotations from VCS when file is opened in editorWhen this option is selected, CLion loads annotations when you open a file in the editor.
Highlight ignored filesWhen this option is selected, CLion shows the list of ignored files from VCS and displays their status in the editor.
Enable Commit tool windowWhen you select this option, CLion displays the Local Changes and Shelf tabs in a separate tool window.
Toggle commit controlsWhen this option is selected, CLion hides the commit panel and checkboxes after the commit is performed and lets you toggle them in the Commit Changes dialog.
Select all repositories with new commits for pushWhen this option is selected, CLion selects all commits that will be pushed by default.

Version Control. Git

ItemDescription
Recursively clone submodules in the projectWhen this option is selected, during the checkout from Git, git clone --recurse-submodules is used that clones the main repository with all available submodules.
Apply content transformation when reading from GitWhen this option is selected, CLion will use the --filters or --textconv flags for the git cat-file command when reading the file content from Git.
Use Safe Force PushWhen this option is selected, CLion uses --force-with-lease when force push is called from the IDE instead of just --force.
Check for incoming and outgoing commitsWhen this option is selected, CLion updates the information on the branches that have incoming or outgoing commits in the Branches popup.
Use Windows certificate storeWhen this option is selected, it forces Git to use Windows certificate store to verify SSL connections. This works for Git 2.14 and later versions.
Last modified: 21 July 2021